Connection-Objekt (ADO)

  • Artikel

Stellt eine offene Verbindung mit einer Datenquelle dar.

Hinweise

Ein Connection-Objekt stellt eine eindeutige Sitzung mit einer Datenquelle dar. Bei einem Client/Server-Datenbanksystem kann es sich dabei um eine tatsächliche Netzwerkverbindung mit dem Server handeln. Je nach Funktionalität, die der Anbieter unterstützt, sind einige Sammlungen, Methoden oder Eigenschaften eines Connection-Objekts möglicherweise nicht verfügbar.

Die Sammlungen, Methoden und Eigenschaften eines Connection-Objekts ermöglichen Ihnen Folgendes:

  • Konfigurieren der Verbindung, bevor sie geöffnet wird, mit den Eigenschaften ConnectionString, ConnectionTimeout und Mode. ConnectionString ist die Standardeigenschaft des Connection-Objekts.

  • Festlegen der CursorLocation-Eigenschaft auf den Client, um den Microsoft-Cursordienst für OLE DB aufzurufen, der Batchaktualisierungen unterstützt.

  • Festlegen der Standarddatenbank für die Verbindung mit der DefaultDatabase-Eigenschaft.

  • Festlegen der Isolationsstufe der geöffneten Transaktionen für die Verbindung mit der IsolationLevel-Eigenschaft.

  • Angeben eines OLE DB-Anbieters mit der Provider-Eigenschaft.

  • Herstellen und späteres Trennen der physischen Verbindung mit der Datenquelle mit den Open- und Close-Methoden.

  • Ausführen eines Befehls für die Verbindung mit der Execute-Methode und Konfigurieren der Ausführung mit der CommandTimeout-Eigenschaft.

    Hinweis

    Wenn Sie eine Abfrage ohne Verwendung eines Command-Objekts ausführen möchten, übergeben Sie eine Abfragezeichenfolge an die Execute-Methode eines Connection-Objekts. Ein Command-Objekt ist jedoch erforderlich, wenn Sie den Befehlstext beibehalten und erneut ausführen möchten oder Abfrageparameter verwenden.

  • Verwalten von Transaktionen für die geöffnete Verbindung (einschließlich geschachtelter Transaktionen, sofern vom Anbieter unterstützt) mit den Methoden BeginTrans, CommitTrans und RollbackTrans sowie der Attributes-Eigenschaft.

  • Untersuchen von Fehlern, die von der Datenquelle zurückgegeben werden, mit der Errors-Sammlung.

  • Lesen der Version aus der verwendeten ADO-Implementierung (ActiveX Data Objects) mit der Version-Eigenschaft.

  • Abrufen von Schemainformationen zur Datenbank mit der OpenSchema-Methode.

Sie können Connection-Objekte unabhängig von allen anderen zuvor definierten Objekten erstellen.

Sie können benannte Befehle oder gespeicherte Prozeduren als native Methoden eines Connection-Objekts ausführen. Dies wird im nächsten Abschnitt gezeigt. Wenn ein benannter Befehl denselben Namen hat wie eine gespeicherte Prozedur, verwenden Sie den „nativen Methodenaufruf“ für ein Connection-Objekt, um immer den benannten Befehl anstelle der gespeicherten Prozedur auszuführen.

Hinweis

Verwenden Sie dieses Feature nicht (aufrufen eines benannten Befehls oder einer gespeicherten Prozedur als wäre es eine systemeigene Methode für das Verbinden ion-Objekt) in einer Microsoft .NET Framework-Anwendung, da die zugrunde liegende Implementierung des Features mit der Art und Weise in Konflikt steht, wie .NET Framework mit COM interagiert.

Ausführen eines Befehls als native Methode eines Connection-Objekts

Geben Sie zum Ausführen eines Befehls mithilfe der Name-Eigenschaft des Command-Objekts einen Namen für den Befehl an. Legen Sie die ActiveConnection-Eigenschaft des Command-Objekts auf die Verbindung fest. Geben Sie dann eine Anweisung aus, in der der Befehlsname wie eine Methode des Connection-Objekts verwendet wird, gefolgt von Parametern und einem Recordset-Objekt, wenn Zeilen zurückgegeben werden. Legen Sie die Recordset-Eigenschaften fest, um das resultierende Recordset anzupassen. Beispiel:

Dim cnn As New ADODB.Connection  
Dim cmd As New ADODB.Command  
Dim rst As New ADODB.Recordset  
...  
cnn.Open "..."  
cmd.Name = "yourCommandName"  
cmd.ActiveConnection = cnn  
...  
'Your command name, any parameters, and an optional Recordset.  
cnn. "parameter", rst

Ausführen einer gespeicherten Prozedur als native Methode eines Connection-Objekts

Geben Sie zum Ausführen einer gespeicherten Prozedur eine Anweisung aus, in der der Name der gespeicherten Prozedur wie eine Methode des Connection-Objekts verwendet wird, gefolgt von Parametern. ADO verwendet Parametertypen nach „bester Schätzung“. Beispiel:

Dim cnn As New ADODB.Connection  
...  
'Your stored procedure name and any parameters.  
cnn. "parameter"

Das Connection-Objekt ist für die Skripterstellung sicher.

Dieser Abschnitt enthält das folgende Thema.

Weitere Informationen

Command-Objekt (ADO)
Errors-Collection (ADO)
Properties-Collection (ADO)
Recordset-Objekt (ADO)
Anhang A: Daten und Dienstanbieter