Programmatisch werken met verbindingsmanagers

Van toepassing op:SQL Server SSIS Integration Runtime in Azure Data Factory

In Integration Services is de AcquireConnection-methode van de bijbehorende connection manager-klasse de methode die je het vaakst aanroept wanneer je met connection managers werkt in managed code. Wanneer je beheerde code schrijft, moet je de AcquireConnection-methode aanroepen om de functionaliteit van een verbindingsmanager te gebruiken. Je moet deze methode aanroepen, ongeacht of je beheerde code schrijft in een scripttaak, scriptcomponent, custom object of custom application.

Om de AcquireConnection-methode succesvol aan te roepen, moet je de antwoorden op de volgende vragen kennen:

  • Welke verbindingsbeheerders geven een beheerd object terug via de AcquireConnection-methode?

    Veel verbindingsbeheerders geven onbeheerde COM-objecten (System.__ComObject) terug en deze objecten kunnen niet eenvoudig worden gebruikt vanuit beheerde code. De lijst van deze verbindingsbeheerders omvat de veelgebruikte OLE DB connection manager.

  • Voor die verbindingsbeheerders die een beheerd object teruggeven, welke objecten geven hun AcquireConnection-methoden dan terug?

    Om de returnwaarde naar het juiste type te casten, moet je weten welk type object de AcquireConnection-methode teruggeeft. Bijvoorbeeld, de AcquireConnection-methode voor de ADO.NET connection manager geeft een open SqlConnection-object terug wanneer je de SqlClient-provider gebruikt. De AcquireConnection-methode voor de File connection manager geeft echter alleen een string terug.

Dit onderwerp beantwoordt deze vragen voor de verbindingsbeheerders die bij Integratiediensten zijn inbegrepen.

Verbindingsbeheerders die geen beheerd object teruggeven

De volgende tabel geeft de verbindingsbeheerders weer die een native COM-object (System.__ComObject) teruggeven vanuit de AcquireConnection-methode. Deze niet-beheerde objecten kunnen niet eenvoudig worden gebruikt vanuit beheerde code.

Verbindingsbeheer Type Verbindingsbeheer Naam
LAWAAI ADO-verbindingsbeheer
MSOLAP90 Verbindingsbeheer voor Analysis Services
Excel Excel-verbindingbeheerder
FTP FTP-verbindingsbeheer
HTTP HTTP-verbindingsbeheer
ODBC ODBC-verbindingsbeheer
OLEDB OLE DB-verbindingsbeheer

Meestal kun je een ADO.NET connection manager vanuit managed code gebruiken om verbinding te maken met een ADO-, Excel-, ODBC- of OLE DB-databron.

Retourwaarden uit de AcquireConnection-methode

De volgende tabel geeft een overzicht van de verbindingsbeheerders die een beheerd object teruggeven vanuit de AcquireConnection-methode. Deze beheerde objecten kunnen eenvoudig worden gebruikt vanuit beheerde code.

Verbindingsbeheer Type Verbindingsbeheer Naam Type Retourwaarde Aanvullende informatie
ADO.NET ADO.NET Verbindingsbeheer System.Data.SqlClient.SqlConnection
FILE Bestandsverbindingsbeheer System.String Pad naar het bestand.
FLATFILE Plat bestandsverbindingsbeheer System.String Pad naar het bestand.
MSMQ MSMQ Verbindingbeheerder (MSMQ Verbindingsbeheer) System.Messaging.MessageQueue
MULTIFILE Verbindingsbeheer voor meerdere bestanden System.String Pad naar een van de bestanden.
MULTIFLATFILE Verbindingsbeheer voor meerdere platte bestanden System.String Pad naar een van de bestanden.
SMOServer SMO Verbindingsbeheer Microsoft. SqlServer.Management.Smo.Server
SMTP SMTP-verbindingsbeheer System.String Bijvoorbeeld: SmtpServer=<server name>;UseWindowsAuthentication=True;EnableSsl=False;
WMI WMI-verbindingsbeheer Systeem.Management.BeheerReikwijdte
SQLMOBILE SQL Server Compact Verbindingsbeheer System.Data.SqlServerCe.SqlCeConnection