Share via

Esempio di gestione connessione personalizzata Excel2

  • Articolo

Data creazione: 14 aprile 2006

Nell'esempio di gestione connessione personalizzata Excel2 viene illustrato come creare una gestione connessione personalizzata, Excel2 Connection Manager, e la relativa interfaccia utente. Questo esempio non è supportato nei sistemi operativi basati su processori Itanium.

Per ulteriori informazioni sulla creazione di una gestione connessione personalizzata, vedere Creating a Custom Connection Manager. Per informazioni generali sull'utilizzo delle gestioni connessioni in Integration Services, vedere Connessioni in Integration Services e Gestioni connessioni.

La gestione connessione personalizzata esegue la connessione a una cartella di lavoro disponibile di Microsoft Excel tramite il provider di dati .NET Framework per OleDb e il provider Microsoft OLE DB per Jet e restituisce un oggetto OleDbConnection aperto dal proprio metodo AcquireConnection. Quando si crea una nuova istanza di Excel2 Connection Manager in un pacchetto, l'interfaccia utente personalizzata chiede il percorso della cartella di lavoro di Excel. Questa gestione connessione include inoltre una casella di controllo per specificare la modalità di importazione. In tal modo viene risolto un problema che si verifica di frequente quando una colonna di Excel include sia dati numerici che di testo.

[!NOTA] Non è possibile utilizzare l'esempio di gestione connessione personalizzata Excel2 con origine e destinazione Excel. Testare l'esempio invece con origine e destinazione DataReader.

Con questo esempio di codice vengono implementate le funzionalità seguenti:

ms365193.note(it-it,SQL.90).gifImportante:
Gli esempi vengono offerti esclusivamente a scopo didattico Non sono progettati per l'utilizzo in un ambiente di produzione e non sono stati testati in un ambiente di produzione. Microsoft non fornisce servizi di supporto tecnico per questi esempi.

Esecuzione dell'esempio

Se non sono necessarie informazioni sulle procedure per l'individuazione, la generazione e l'installazione degli esempi di codice, è possibile passare direttamente alla sezione Test dell'esempio per informazioni sulla configurazione e l'esecuzione dell'esempio.

Prerequisiti

Per l'esecuzione di questo esempio è necessario che siano installati i componenti seguenti.

  • Microsoft Visual Studio 2005
  • Microsoft SQL Server 2005 Integration Services

Percorso

Se l'esempio di codice è stato installato nel percorso predefinito, l'esempio si trova nella directory seguente:

C:\Programmi\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Control Flow\Excel2ConnectionManager Sample

La versione C# dell'esempio di codice si trova nella directory Excel2ConnMgrCS, mentre la versione Visual Basic si trova nella directory Excel2ConnMgrVB.

Per ulteriori informazioni sul processo in due fasi necessario per l'installazione degli esempi, vedere Installazione degli esempi. Per ottenere la versione più recente degli esempi, inclusi nuovi esempi resi disponibili dopo il rilascio di SQL Server 2005, vedere Esempi e database di esempio di SQL Server 2005 (aprile 2006).

Generazione dell'esempio

Se non è stato ancora generato un file di chiave con nome sicuro nella cartella Samples, eseguire la procedura seguente per generarlo. Nella scheda Firma della finestra di dialogo Proprietà progetto sono configurati progetti di esempio per la firma di assembly durante la generazione con questo file di chiave.

Per generare un file di chiave con nome sicuro

  1. Per aprire il prompt dei comandi di Microsoft Visual Studio 2005, fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft Visual Studio 2005, Visual Studio Tools e quindi fare clic su Prompt dei comandi di Visual Studio 2005.

    -oppure-

    Per aprire il prompt dei comandi di Microsoft .NET Framework, fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft .NET Framework SDK v2.0 e quindi fare clic su SDK Command Prompt.

  2. Al prompt dei comandi mediante il comando CD (change directory) passare dalla directory corrente della finestra del prompt dei comandi alla cartella Samples. Il file di chiave creato in questa cartella verrà utilizzato da tutti gli esempi di codice di SQL Server 2005.

    [!NOTA] Per determinare la cartella in cui si trovano gli esempi, fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft SQL Server 2005, Documentazione ed esercitazioni e quindi Directory esempi. Se è stato utilizzato il percorso di installazione predefinito, gli esempi si troveranno in <system_drive>:\Programmi\Microsoft SQL Server\90\Samples.

  3. Al prompt dei comandi digitare il comando seguente per generare il file di chiave:

    sn -k SampleKey.snk
    ms365193.note(it-it,SQL.90).gifImportante:
    Per ulteriori informazioni sulla coppia di chiavi con nome sicuro, vedere l'argomento relativo ai nomi sicuri e alla protezione in .NET Framework nel centro per sviluppatori di .NET su MSDN (informazioni in lingua inglese).

  4. Il token di chiave pubblica del file di chiave sarà necessario in un passaggio successivo. Per ottenere il token di chiave pubblica, estrarre innanzitutto la chiave pubblica dal file di chiave eseguendo il comando seguente al prompt dei comandi:

    sn -p SampleKey.snk SampleKeyPublic.snk

    A questo punto visualizzare il token di chiave pubblica dal nuovo file eseguendo il comando seguente al prompt dei comandi:

    sn -t SampleKeyPublic.snk

    Copiare il token di chiave pubblica negli Appunti o salvarlo per un utilizzo futuro.

Per generare l'esempio in Microsoft Visual Studio 2005

  1. Scegliere Apri dal menu File, fare clic su Progetto e aprire Excel2ConnMgrVB.sln o Excel2ConnMgrCS.sln.

  2. In Esplora soluzioni selezionare il progetto Excel2ConnMgrVB o Excel2ConnMgrCS.

  3. Individuare l'attributo DtsConnection prima della dichiarazione di classe nel file Excel2ConnMgrCS.cs o Excel2ConnMgrVB.vb e sostituire il valore alfanumerico del token di chiave pubblica nella proprietà UITypeName dell'attributo con il token di chiave pubblica ottenuto in precedenza dal file di chiave.

  4. Scegliere Genera soluzione dal menu Genera per generare la soluzione.

Installazione dell'esempio

Questo esempio è disponibile in Visual Basic e C#. Per distinguere gli assembly delle due versioni dell'esempio, al nome degli assembly di output sono stati aggiunti i suffissi CS e VB. Dopo aver generato il componente, eseguire la procedura seguente per aggiungerlo come gestione connessione in un pacchetto di Business Intelligence Development Studio.

Per copiare il componente nella cartella Connections

  1. Aprire Esplora risorse o l'applicazione desiderata per le operazioni nel file system.

  2. Copiare gli assembly (Excel2ConnMgrCS.dll e Excel2ConnMgrUICS.dll oppure Excel2ConnMgrVB.dll e Excel2ConnMgrUIVB.dll) nella cartella Connections in %system%\Program Files\Microsoft SQL Server\90\DTS\Connections.

Per installare il componente nella cache di assembly globale (CAG) trascinando gli assembly

  1. Aprire Esplora risorse o l'applicazione desiderata per le operazioni nel file system.

  2. Trascinare gli assembly dalla cartella Connections alla cartella in cui si trova la cache di assembly globale (CAG), nel percorso %system%\assembly.

Per installare il componente nella cache di assembly globale (CAG) tramite gacutil.exe

  1. Aprire la finestra del prompt dei comandi.

  2. Digitare i comandi seguenti per installare la versione C# del componente e l'interfaccia utente nella cache di assembly globale (CAG):

    gacutil.exe -iF "C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\Excel2ConnectionManager Sample\CS\Excel2ConnMgrCS\bin\Debug\Excel2ConnMgrCS.dll"
gacutil.exe -iF "C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\Excel2ConnectionManager Sample\CS\Excel2ConnMgrUICS\bin\Debug\Excel2ConnMgrUICS.dll"

    -oppure-

    Digitare i comandi seguenti per installare la versione Visual Basic del componente e l'interfaccia utente nella cache di assembly globale (CAG):

    gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\Excel2ConnectionManager Sample\VB\Excel2ConnMgrVB\bin\Debug\Excel2ConnMgrVB.dll"
gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\Excel2ConnectionManager Sample\VB\Excel2ConnMgrVB\bin\Debug\Excel2ConnMgrUIVB.dll"

Test dell'esempio

A questo punto è possibile testare la gestione connessione personalizzata in un pacchetto.

Per utilizzare la gestione connessione di esempio in un pacchetto

  1. Nell'area delle gestioni connessioni di Progettazione SSIS fare clic con il pulsante destro del mouse e scegliere Nuova connessione, quindi scegliere EXCEL2 nell'elenco dei tipi di connessione disponibili. Fare clic su OK.

  2. Modificare la nuova gestione connessione. Nell'Editor gestione connessione Excel2 individuare una cartella di lavoro di Excel disponibile. Utilizzare le caselle di controllo per specificare le impostazioni relative alle intestazioni e alla modalità di importazione.

    [!NOTA] L'esempio di gestione connessione personalizzata Excel2 non può essere utilizzato con origine Excel, che supporta solo la gestione connessione predefinita di Excel. Testare l'esempio con origine DataReader.