Utilizzo di gestioni connessioni a livello di programmazione
Si applica a: 
SQL Server SSIS Integration Runtime 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 | Gestione connessione Analysis Services |
| 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 | Gestione connessione file flat | 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 |
Vedi anche
Connessione a origini dati nell'attività Script
Connessione a origini dati nel componente script
Connessione alle origini dati in un'attività personalizzata