Freigeben über


ConnectionManager Klasse

Definition

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
ConnectionManager
Implementiert

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: