Freigeben über

Connection-Objekt (ADO)

  • Artikel

Stellt eine offene Verbindung mit einer Datenquelle dar.

Bemerkungen

Ein Connection-Objekt stellt eine eindeutige Sitzung mit einer Datenquelle dar. In einem Client-/Serverdatenbanksystem kann es einer tatsächlichen Netzwerkverbindung mit dem Server entsprechen. Abhängig von der vom Anbieter unterstützten Funktionalität sind einige Auflistungen, Methoden oder Eigenschaften eines Connection-Objekts möglicherweise nicht verfügbar.

Mit den Auflistungen, Methoden und Eigenschaften eines Connection-Objekts können Sie folgende Aktionen ausführen:

  • Konfigurieren Sie die Verbindung vor dem Öffnen mit den eigenschaften ConnectionString, ConnectionTimeoutund Mode. ConnectionString- ist die Standardeigenschaft des Connection-Objekts.

  • Legen Sie die CursorLocation-Eigenschaft auf Client fest, um den Microsoft Cursor Service für OLE DB-aufzurufen, der Batchaktualisierungen unterstützt.

  • Legen Sie die Standarddatenbank für die Verbindung mit der DefaultDatabase-Eigenschaft fest.

  • Legen Sie die Isolationsebene für die Transaktionen fest, die für die Verbindung mit der IsolationLevel-Eigenschaft geöffnet wurden.

  • Geben Sie einen OLE DB-Anbieter mit der eigenschaft Provider an.

  • Stellen Sie die physische Verbindung mit der Datenquelle mit den Methoden Open und Close fest.

  • Führen Sie einen Befehl für die Verbindung mit der Execute-Methode aus, und konfigurieren Sie die Ausführung mit der eigenschaft CommandTimeout.

    Anmerkung

    Um eine Abfrage ohne Verwendung eines Command-Objekts auszuführen, ü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 oder Abfrageparameter verwenden möchten.

  • Verwalten Sie Transaktionen für die geöffnete Verbindung, einschließlich geschachtelter Transaktionen, wenn der Anbieter sie unterstützt, mit den methoden BeginTrans, CommitTransund RollbackTrans Methoden und der Attributes-Eigenschaft.

  • Untersuchen Sie fehler, die von der Datenquelle mit der Errors Collection zurückgegeben werden.

  • Lesen Sie die Version aus der ADO-Implementierung, die mit der eigenschaft Version verwendet wird.

  • Rufen Sie Schemainformationen zu Ihrer Datenbank mit der OpenSchema--Methode ab.

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

Sie können benannte Befehle oder gespeicherte Prozeduren so ausführen, als wären sie systemeigene Methoden für ein Connection-Objekt, wie im nächsten Abschnitt gezeigt. Wenn ein benannter Befehl denselben Namen wie der einer gespeicherten Prozedur hat, rufen Sie den "systemeigenen Methodenaufruf" für ein Connection -Objekt immer den benannten Befehl anstelle der Speicherprozedur aus.

Anmerkung

Verwenden Sie dieses Feature (aufrufen eines benannten Befehls oder einer gespeicherten Prozedur so, als wäre es eine systemeigene Methode für das Connection-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 systemeigene Methode eines Connection-Objekts

Um einen Befehl auszuführen, geben Sie dem Befehl einen Namen mithilfe des Command-Objekts Name-Eigenschaft. Legen Sie die ActiveConnection- eigenschaft des Command-Objekts auf die Verbindung fest. Geben Sie dann eine Anweisung aus, in der der Befehlsname verwendet wird, als ob es sich um eine Methode für das Connection-Objekt handelt, gefolgt von Parametern und einem Recordset-Objekt, wenn Zeilen zurückgegeben werden. Legen Sie die Recordset- Eigenschaften fest, um das resultierende Recordset-anzupassen. Zum 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 systemeigene Methode eines Connection-Objekts

Um eine gespeicherte Prozedur auszuführen, geben Sie eine Anweisung aus, in der der Name der gespeicherten Prozedur verwendet wird, als wäre es eine Methode für das Connection-Objekt, gefolgt von parametern. ADO macht einen "besten Schätzwert" von Parametertypen. Zum Beispiel:

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

Das Connection-Objekt ist für Skripts sicher.

Dieser Abschnitt enthält das folgende Thema.

Siehe auch

Command-Objekt (ADO)
Errors-Auflistung (ADO)
Properties-Auflistung (ADO)
Recordset-Objekt (ADO)
Anhang A: Anbieter