ConnectionManager Klasse

Referenz

Definition

Namespace:: Microsoft.SqlServer.Dts.Runtime

Assembly:: Microsoft.SqlServer.ManagedDTS.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt die Informationen bereit, die Sie für die Verbindung mit einer Datenquelle benötigen. Alle Klassen, die von ConnectionManager erben, enthalten die gleichen Eigenschaften und Methoden. Durch die ConnectionManager-Klasse werden die Implementierungsdetails der verschiedenen Verbindungstypen aus der Laufzeit isoliert. Daher kann die Laufzeit mit den einzelnen Verbindungs-Managern auf eine konsistente, vorhersehbare Weise interagieren. Verbindungs-Manager enthalten eine Reihe von Basiseigenschaften, die alle Verbindungen gemeinsam haben, z. B. die Name-, die ID- Description und die ConnectionString-Eigenschaft. Die einzelnen Verbindungstypen verfügen jedoch über zusätzliche Eigenschaften, die spezifisch für den jeweiligen Verbindungstyp sind. Auf sie kann über die Properties-Auflistung zugegriffen werden. Diese Klasse kann nicht vererbt werden.

public ref class ConnectionManager sealed : Microsoft::SqlServer::Dts::Runtime::DtsObject, IDisposable, Microsoft::SqlServer::Dts::Runtime::IDTSExecutionPath, Microsoft::SqlServer::Dts::Runtime::IDTSName, Microsoft::SqlServer::Dts::Runtime::IDTSObjectHost, Microsoft::SqlServer::Dts::Runtime::IDTSPackagePath, Microsoft::SqlServer::Dts::Runtime::IDTSPersist, Microsoft::SqlServer::Dts::Runtime::IDTSPropertiesProvider, Microsoft::SqlServer::Dts::Runtime::IDTSPropertiesProviderEx, System::ComponentModel::IComponent

public sealed class ConnectionManager : Microsoft.SqlServer.Dts.Runtime.DtsObject, IDisposable, Microsoft.SqlServer.Dts.Runtime.IDTSExecutionPath, Microsoft.SqlServer.Dts.Runtime.IDTSName, Microsoft.SqlServer.Dts.Runtime.IDTSObjectHost, Microsoft.SqlServer.Dts.Runtime.IDTSPackagePath, Microsoft.SqlServer.Dts.Runtime.IDTSPersist, Microsoft.SqlServer.Dts.Runtime.IDTSPropertiesProvider, Microsoft.SqlServer.Dts.Runtime.IDTSPropertiesProviderEx, System.ComponentModel.IComponent

type ConnectionManager = class
    inherit DtsObject
    interface IDTSObjectHost
    interface IDTSPersist
    interface IDTSName
    interface IComponent
    interface IDisposable
    interface IDTSPropertiesProvider
    interface IDTSPropertiesProviderEx
    interface IDTSPackagePath
    interface IDTSExecutionPath

Public NotInheritable Class ConnectionManager
Inherits DtsObject
Implements IComponent, IDisposable, IDTSExecutionPath, IDTSName, IDTSObjectHost, IDTSPackagePath, IDTSPersist, IDTSPropertiesProvider, IDTSPropertiesProviderEx

Vererbung: Object

DtsObject
ConnectionManager

Implementiert: IDTSExecutionPath IDTSName IDTSObjectHost IDTSPackagePath IDTSPersist IDTSPropertiesProvider IDTSPropertiesProviderEx IComponent IDisposable

Hinweise

Ein Verbindungs-Manager ist eine logische Darstellung einer Verbindung. Zur Entwurfszeit verwenden Sie in der grafischen Benutzeroberfläche einen Verbindungs-Manager, um die physische Verbindung zu beschreiben, die die Laufzeit beim Ausführen des Pakets erstellt. Integration Services bietet verschiedene Arten von Verbindungsmanagern, mit denen Pakete eine Verbindung mit einer Vielzahl von Datenquellen herstellen können. Beispielsweise gibt es einen ActiveX Data Objects (ADO)-Verbindungs-Manager, einen ADO.NET Verbindungs-Manager, einen ODBC-Verbindungs-Manager usw. Weitere Informationen finden Sie unter Erweitern von Paketen mit benutzerdefinierten Objekten.

Eigenschaften

ConnectionString	Ruft die zum Herstellen einer Verbindung mit einer Datenquelle verwendete Verbindungszeichenfolge ab oder legt sie fest.
CreationName	Gibt die Zeichenfolge zurück, die von der Laufzeit zum Erstellen einer Instanz des ConnectionManager-Objekts und zum Hinzufügen des Objekts zur Connections-Auflistung verwendet wird. Diese Eigenschaft ist schreibgeschützt.
DelayValidation	Dient zum Abrufen oder Festlegen eines booleschen Werts, der angibt, ob die Paketüberprüfung verzögert wird, bis das Paket ausgeführt wird.
Description	Ruft die Beschreibung des ConnectionManager-Objekts ab oder legt sie fest.
HasExpressions	Ruft einen Wert ab, der angibt, ob für den Verbindungs-Manager Eigenschaften durch Ausdrücke festgelegt wurden.
HostType	Ruft eine Enumeration ab, die den Hosttyp beschreibt, von dem die Verbindung verwendet wird. Diese Eigenschaft ist schreibgeschützt.
ID	Ruft die ID von ConnectionManager ab. Diese Eigenschaft ist schreibgeschützt.
InnerObject	Gibt den erstellten spezifischen Verbindungstyp zurück. Diese Eigenschaft ist schreibgeschützt.
Name	Ruft den Namen des ConnectionManager-Objekts ab oder legt ihn fest.
OfflineMode	Ruft einen Wert ab, der angibt, ob der Verbindungs-Manager im Offlinemodus ist, oder legt ihn fest.
Properties	Ruft eine Auflistung von Eigenschaftenobjekten für ConnectionManager ab. Diese Vorgehensweise wird für den Zugriff auf die Eigenschaften der spezifischen Verbindung verwendet, die vom Verbindungs-Manager gehostet wird. Diese Eigenschaft ist schreibgeschützt.
ProtectionLevel	Ruft die Verschlüsselungsebene ab, die auf sensible, im Paket enthaltene Daten angewendet wird, oder legt sie fest.
Qualifier	Ruft den Qualifizierer für den Verbindungs-Manager ab oder legt ihn fest.
Scope	Ruft den Bereich des Verbindungs-Managers ab.
Site	Ruft die Site des Verbindungs-Managers ab oder legt sie fest.
SupportsDTCTransactions	Gibt einen booleschen Wert zurück, der angibt, ob die Verbindung MS DTC-Transaktionen (Microsoft Distributed Transaction Coordinator) unterstützt.
VariableDispenser	Ruft den Verteiler der Variablen im Verbindungs-Manager ab.
Variables	Ruft die Auflistung der Variablen im Verbindungs-Manager ab.

Methoden

AcquireConnection(Object)	Erstellt eine Instanz des Verbindungstyps.
Dispose()	Gibt die von der ConnectionManager verwendeten Ressourcen frei.
Equals(Object)	Stellt fest, ob zwei Objektinstanzen gleich sind. (Geerbt von DtsObject)
GetExecutionPath()	Gibt den Ausführungspfad des Verbindungs-Managers zurück.
GetExpression(String)	Gibt eine Zeichenfolge zurück, die den Ausdruck für die angegebene Eigenschaft enthält. Null bedeutet, dass kein Ausdruck zugewiesen wurde.
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von DtsObject)
GetPackagePath()	Ruft den Pfad des Pakets ab, auf das die Verbindung angewendet wird, oder legt ihn fest.
LoadFromXML(String, IDTSEvents)	Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Um ein im XML-Format gespeichertes Paket zu laden, verwenden Sie die LoadPackage(String, IDTSEvents)-Methode.
LoadFromXML(XmlNode, IDTSEvents)	Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Um ein im XML-Format gespeichertes Paket zu laden, verwenden Sie die LoadPackage(String, IDTSEvents)-Methode.
ReleaseConnection(Object)	Gibt die während AcquireConnection(Object) hergestellte Verbindung frei. Wird zur Entwurfs- und Laufzeit aufgerufen.
SaveToXML(XmlDocument, XmlNode, IDTSEvents)	Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Um ein Paket als XML-Datei zu speichern, verwenden Sie die SaveToXml(String, Package, IDTSEvents)-Methode.
SetExpression(String, String)	Weist der Eigenschaft den angegebenen Ausdruck zu. Geben Sie null an, um einen vorhandenen Ausdruck aus der Eigenschaft zu entfernen.
SetQualifier(String)	Ändert einen Qualifizierer für den Verbindungs-Manager, nachdem der Verbindungs-Manager erstellt wurde, aber bevor er in einem ausgeführten Paket verwendet wird.

Ereignisse

Disposed

Fügt einen Ereignishandler hinzu, der auf das Disposed-Ereignis für ConnectionManager lauscht.

Gilt für:

Freigeben über