Utilisation de gestionnaires de connexions par programme
Dans Integration Services, la méthode AcquireConnection de la classe de gestionnaire de connexions associée est celle que vous appelez le plus souvent lorsque vous utilisez des gestionnaires de connexions en code managé. Lorsque vous écrivez du code managé, vous devez appeler la méthode AcquireConnection pour utiliser les fonctionnalités d'un gestionnaire de connexions. Vous devez appeler cette méthode que vous écriviez du code managé dans une tâche de script, un composant Script, un objet personnalisé ou une application personnalisée.
Pour appeler correctement la méthode AcquireConnection vous devez savoir répondre aux questions suivantes :
Quels gestionnaires de connexions retournent un objet managé à partir de la méthode AcquireConnection ?
De nombreux gestionnaires de connexions retournent des objets COM non managés (System.__ComObject) et ces objets ne peuvent pas être facilement utilisés à partir du code managé. La liste de ces gestionnaires de connexions inclut le gestionnaire de connexions OLE DB fréquemment utilisé.
Pour les gestionnaires de connexions qui retournent un objet managé, quels sont les objets retournés par leurs méthodes AcquireConnection ?
Pour effectuer un cast de la valeur de retour en type approprié, vous devez connaître le type d'objet retourné par la méthode AcquireConnection. Par exemple, la méthode AcquireConnection du gestionnaire de connexions ADO.NET retourne un objet SqlConnection ouvert lorsque vous utilisez le fournisseur SqlClient. Toutefois, la méthode AcquireConnection du gestionnaire de connexions de fichiers ne retourne qu'une chaîne.
Cette rubrique répond à ces questions pour les gestionnaires de connexions inclus dans Integration Services.
Gestionnaires de connexions qui ne retournent pas un objet managé
Le tableau suivant répertorie les gestionnaires de connexions qui retournent un objet COM natif (System.__ComObject) à partir de la méthode AcquireConnection. Ces objets non managés ne peuvent pas être facilement utilisés à partir du code managé.
Type du gestionnaire de connexions |
Nom du gestionnaire de connexions |
---|---|
ADO |
Gestionnaire de connexions ADO |
MSOLAP90 |
Gestionnaire de connexions Analysis Services |
EXCEL |
Gestionnaire de connexions Excel |
FTP |
Gestionnaire de connexions FTP |
HTTP |
Gestionnaire de connexions HTTP |
ODBC |
Gestionnaire de connexions ODBC |
OLEDB |
Gestionnaire de connexions OLE DB |
En général, vous pouvez utiliser un gestionnaire de connexions ADO.NET à partir de code managé pour vous connecter à une source de données ADO, Excel, ODBC ou OLE DB.
Valeurs de retour de la méthode AcquireConnection
Le tableau suivant répertorie les gestionnaires de connexions qui retournent un objet managé à partir de la méthode AcquireConnection. Ces objets managés peuvent être facilement utilisés à partir du code managé.
Type du gestionnaire de connexions |
Nom du gestionnaire de connexions |
Type de valeur de retour |
Informations supplémentaires |
---|---|---|---|
ADO.NET |
Gestionnaire de connexions ADO.NET |
System.Data.SqlClient.SqlConnection |
|
FILE |
Gestionnaire de connexions de fichiers |
System.String |
Chemin d'accès au fichier. |
FLATFILE |
Gestionnaire de connexions de fichiers plats |
System.String |
Chemin d'accès au fichier. |
MSMQ |
Gestionnaire de connexions MSMQ |
System.Messaging.MessageQueue |
|
MULTIFILE |
Gestionnaire de connexions de fichiers multiples |
System.String |
Chemin d'accès à l'un des fichiers. |
MULTIFLATFILE |
Gestionnaire de connexions de fichiers plats multiples |
System.String |
Chemin d'accès à l'un des fichiers. |
SMOServer |
Gestionnaire de connexions SMO |
Microsoft.SqlServer.Management.Smo.Server |
|
SMTP |
Gestionnaire de connexions SMTP |
System.String |
Par exemple : SmtpServer=<server name>;UseWindowsAuthentication=True;EnableSsl=False; |
WMI |
Gestionnaire de connexions WMI |
System.Management.ManagementScope |
|
SQLMOBILE |
Gestionnaire de connexions SQL Server Compact |
System.Data.SqlServerCe.SqlCeConnection |
|