Utilizzo di gestioni connessioni a livello di programmazione

Si applica a:SQL Server Integration Runtime SSIS in Azure Data Factory

In Integration Services il metodo AcquireConnection della classe della gestione connessione associata è quello che viene chiamato più spesso quando si usano gestioni connessioni in codice gestito. Quando si scrive codice gestito, è necessario chiamare il metodo AcquireConnection per usare la funzionalità di una gestione connessione. È necessario chiamare questo metodo sia che il codice gestito venga scritto in un'attività Script, in un componente script, in un oggetto personalizzato o in un'applicazione personalizzata.

Per chiamare correttamente il metodo AcquireConnection, è necessario conoscere le risposte alle domande seguenti:

• Quali gestioni connessioni restituiscono un oggetto gestito dal metodo AcquireConnection?

  Molte gestioni connessioni restituiscono oggetti COM non gestiti (System.__ComObject), che non possono essere facilmente usati da codice gestito. L'elenco di queste gestioni connessioni include la gestione connessione OLE DB utilizzata di frequente.

• Per le gestioni connessioni che restituiscono un oggetto gestito, quali oggetti vengono restituiti dai relativi metodi AcquireConnection?

  Per eseguire il cast del valore restituito nel tipo appropriato, è necessario conoscere il tipo di oggetto restituito dal metodo AcquireConnection. Ad esempio, il metodo AcquireConnection per la gestione connessione di ADO.NET restituisce un oggetto SqlConnection aperto quando si usa il provider SqlClient. Tuttavia, il metodo AcquireConnection per la gestione connessione file restituisce solo una stringa.

In questo argomento vengono fornite le risposte a queste domande per le gestioni connessioni incluse in Integration Services.

Gestioni connessione che non restituiscono un oggetto gestito

La tabella seguente elenca le gestioni connessioni che restituiscono un oggetto COM nativo (System.__ComObject) dal metodo AcquireConnection. Tali oggetti non gestiti non possono essere facilmente utilizzati da codice gestito.

Tipo di gestione connessione	Nome gestione connessione
ADO	Gestione connessione ADO
MSOLAP90	Analysis Services - gestione connessione
EXCEL	Gestione connessione Excel
FTP	gestione connessione FTP
HTTP	gestione connessione HTTP
ODBC	gestione connessione ODBC
OLEDB	gestione connessione OLE DB

In genere, è possibile usare una gestione connessione di ADO.NET da codice gestito per connettersi a un'origine dati ADO, Excel, ODBC o OLE DB.

Valori restituiti dal metodo AcquireConnection

La tabella seguente elenca le gestioni connessioni che restituiscono un oggetto gestito dal metodo AcquireConnection. Tali oggetti gestiti possono essere facilmente utilizzati da codice gestito.

Tipo di gestione connessione	Nome gestione connessione	Tipo di valore restituito	Informazioni aggiuntive
ADO.NET	Gestione connessione ADO.NET	System.Data.SqlClient.SqlConnection
FILE	gestione connessione file	System.String	Percorso del file.
FLATFILE	Flat File Connection Manager	System.String	Percorso del file.
MSMQ	gestione connessione MSMQ	System.Messaging.MessageQueue
MULTIFILE	gestione connessione per più file	System.String	Percorso di uno dei file.
MULTIFLATFILE	gestione connessione per più file flat	System.String	Percorso di uno dei file.
SMOServer	gestione connessione SMO	Microsoft.SqlServer.Management.Smo.Server
SMTP	Gestione connessione SMTP	System.String	Ad esempio: SmtpServer=<server name>;UseWindowsAuthentication=True;EnableSsl=False;
WMI	Gestione connessione WMI	System.Management.ManagementScope
SQLMOBILE	Gestione connessione SQL Server Compact	System.Data.SqlServerCe.SqlCeConnection

Vedere anche

Connessione a origini dati nell'attività Script
Connessione a origini dati nel componente script
Connessione alle origini dati in un'attività personalizzata