Utilisation de gestionnaires de connexions par programme

  • Article

S’applique à :SQL Server SSIS Integration Runtime dans Azure Data Factory

Dans Integration Services, la méthode AcquireConnection de la classe de gestionnaire de connexions associée est celle que vous appelez le plus souvent quand vous utilisez des gestionnaires de connexions dans le code managé. Quand 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 pouvoir 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) qui 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 caster 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 quand 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 Gestionnaires de connexion 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

Voir aussi

Connexion à des sources de données dans la tâche de script
Connexion aux sources de données dans le composant Script
Connexion à des sources de données dans une tâche personnalisée