Connection-Objekt (Versionen 2.0, 2.1, 2.5 und 2.6)
Dim connection As ADODB.Connection

Das Objekt Connection, ein Verbindungsobjekt, stellt eine eindeutige Verbindung zu einer Datenquelle dar. Connection-Objekte hängen von allen übrigen ADO-Objekten ab.

Eigenschaft Connection.Attributes (Versionen 2.0, 2.1, 2.5 und 2.6)

Connection.Attributes = XactArgumentsEnum [+ XactArgumentsEnum...]
 

Die Eigenschaft Attributes dient zum Festlegen oder Zurückgeben spezifischer Eigenschaften des Objekts Connection.

Datentyp

XactArgumentsEnum (Long)

 
Beschreibung

Für die Eigenschaft Attributes besteht Lese- und Schreibberechtigung. Der Wert der Eigenschaft Attributes kann auf eine beliebige Summe der in Anhang E aufgeführten Enumerationswerte für XactArgumentsEnum gesetzt werden.

Der Standardwert der Eigenschaft Attributes ist Null.

 
Hinweis

Nicht alle Provider unterstützen den Funktionsumfang der Eigenschaft Attributes.

 
Siehe auch

Methode Connection.BeginTrans, Methode Connection.CommitTrans, Methode Connection.RollBackTrans, Enumeration XactAttributeEnum

 
Methode Connection.BeginTrans CBT-Methode (Versionen 2.0, 2.1, 2.5 und 2.6)

connection.BeginTrans
level = connection.BeginTrans( )
connection.CommitTrans
connection.RollbackTrans
 

Mit den Methoden BeginTrans, CommitTrans und RollbackTrans lässt sich die Verarbeitung der Transaktionen für das aktuelle Connection-Objekt verwalten.

Wie schon der Name sagt, startet die Methode BeginTrans eine Transaktion.

Die Methode CommitTrans speichert zunächst etwaige Änderungen, beendet die aktuelle Transaktion und startet dann u. U. eine weitere Transaktion.

Die Methode RollbackTrans beendet die aktuelle Transaktion, macht aber etwaige während der aktuellen Transaktion vorgenommene Änderungen rückgängig. Außerdem kann die Methode RollbackTrans ebenso wie die Methode CommitTrans eine weitere Transaktion starten.

Beschreibung

Die Methoden BeginTrans, CommitTrans und RollbackTrans des Objekts Connection dienen zur Transaktionsverwaltung innerhalb einer bestimmten Verbindung. Das offensichtlichste Beispiel für den Bedarf einer Transaktionsverwaltung sind Banking-Systeme. Bei der Überweisung von Geld von einem Konto auf ein anderes müssen die beiden Teilschritte (Abhebung und anschließende Einzahlung) als eine einzelne Transaktion erfolgen. Mit Hilfe dieser drei Methoden zur Transaktionsverwaltung lässt sich gewährleisten, dass entweder beide oder keiner dieser Schritte (nicht aber einer allein) durchgeführt werden. Sollte sich nach dem Abheben ein Problem mit der Einzahlung ergeben, können wir dank der Methode RollbackTrans sozusagen die Zeit zurückspulen.

Mit der Methode BeginTrans wird innerhalb des aktuellen Connection-Objekts eine neue Transaktion gestartet. Die Methode BeginTrans ermöglicht es Ihnen, verschachtelte Transaktionen zu erzeugen, ähnlich wie Sie verschachtelte If . . . Then-Anweisungen im Code erzeugen können. Wenn der Datenprovider verschachtelte Transaktionen unterstützt, kann mit der Methode BeginTrans ein Rückgabewert in der Form eines Long-Datentyps abgerufen werden. Dieser Rückgabewert gibt die Ebene der erzeugten verschachtelten Transaktion wieder. Eins (1) steht dabei für die erste Ebene.

Die Methode CommitTrans übernimmt alle seit Beginn der letzten Transaktion vorgenommenen Änderungen. Das Gegenteil bewirkt die Methode RollbackTrans: Sie macht alle Änderungen an der letzten Transaktion rückgängig. In beiden Fällen wird die letzte Transaktion beendet. Außerdem muss die zuletzt erzeugte Transaktion beendet sein, bevor eine der Methoden CommitTrans oder RollbackTrans eine frühere Transaktion beenden kann.

Wenn die Eigenschaft Arguments des Objekts Connection auf adXactCommitRetaining gesetzt ist, wird nach einem Aufruf der Methode CommitTrans automatisch eine neue Transaktion erzeugt. Ist die Eigenschaft auf adXactAbortRetaining gesetzt, wird nach einem Aufruf der Methode RollbackTrans automatisch eine neue Transaktion erzeugt.

 
Siehe auch

Eigenschaft Connection.Arguments

 
Ereignis Connection.BeginTransComplete (Versionen 2.0, 2.1, 2.5 und 2.6)

Private Sub BeginTransComplete(ByVal TransactionLevel As Long, _
ByVal pError As ADODB.Error, _
adStatus As ADODB.EventStatusEnum, _
ByVal pConnection As ADODB.Connection)
 

Das Ereignis BeginTransComplete tritt ein, wenn die Methode BeginTrans ihre Operation abgeschlossen hat.

Argumente
TransactionLevel

Ein Long-Wert, der die Verschachtelungsebene der neuen Transaktion wiedergibt.

pError

Ein Error-Objekt mit Detailangaben über einen aufgetretenen Fehler, sofern der Parameter adStatus auf adStatusErrorsOccurred gesetzt ist.

adStatus

Ein EventStatusEnum-Wert, der den Status der aktuellen Operation darstellt. Wenn der Parameter adStatus auf adStatusOK gesetzt ist, bedeutet dies, dass die Operation erfolgreich verlaufen ist. Weist der Parameter adStatus den Wert adStatusErrorsOccurred auf, so ist die Operation fehlgeschlagen, und das Objekt pError enthält genaue Auskunft über den Fehler. Indem Sie den Parameter adStatus auf adStatusUnwantedEvent setzen, wird dieses Ereignis nicht mehr aufgerufen.

pConnection

Das Connection-Objekt, das dieses Ereignis ausgelöst hat.

 
Siehe auch

Methode Connection.BeginTrans, Ereignis Connection.CommitTransComplete, Ereignis Connection.RollbackTransComplete, Enumeration EventStatusEnum

 
Methode Connection.Cancel (Versionen 2.0, 2.1, 2.5 und 2.6)

connection.Cancel
 

Die Methode Cancel bricht die ausstehende asynchrone Verbindung oder Ausführung ab.

Beschreibung

Wenn die Methoden Execute oder Open eines Connection-Objekts mit einer der Optionen adAsyncConnect, adAsyncExecute oder adAsyncFetch aufgerufen wurden, bricht die Methode Cancel die ausstehende asynchrone Operation ab.

Wenn die Methode Cancel für eine Operation aufgerufen wird, die nicht mit gesetzter Option adAsyncExecute aufgerufen wurde, tritt ein Fehler auf.

 
Siehe auch

Methode Connection.Execute, Methode Connection.Open

 
Methode Connection.Close (Versionen 2.0, 2.1, 2.5 und 2.6)

connection.Close
 

Die Methode Close dient zum Schließen eines Connection- oder eines Recordset-Objekts einschließlich etwaiger von ihnen abhängiger Objekte.

Beschreibung

Die Methode Close beendet eine Verbindung zu einer Datenquelle. Nachdem ein Connection-Objekt geschlossen wurde, können die Eigenschaften angepasst und das Objekt anschließend wieder geöffnet werden. Wenn Sie bei geschlossenem Connection-Objekt eine Methode aufrufen, die eine Verbindung benötigt, entsteht ein Fehler.

Durch das Schließen eines Connection-Objekts, aus dem ein oder mehrere Recordset-Objekte erzeugt wurden, schließen sich auch diese Recordset-Objekte. Sämtliche neuen Änderungen gehen verloren. Falls auch eine Transaktion aussteht, tritt ein Fehler auf.

Durch das Schließen eines Connection-Objekts wird dieses nicht aus dem Speicher entfernt. Es gibt lediglich die verwendeten Ressourcen frei. In Visual Basic entfernen Sie das Objekt Connection aus dem Speicher, indem Sie es auf Nothing setzen.

 
Eigenschaft Connection.CommandTimeout (Versionen 2.0, 2.1, 2.5 und 2.6)

connection.CommandTimeout = timeout
 

Die Eigenschaft CommandTimeout gibt an, wie lange bei der Ausführung eines bestimmten Befehls gewartet wird, bevor ADO einen Fehler generiert.

Datentyp

Long

 
Beschreibung

Für die Eigenschaft CommandTimeout besteht Lese- und Schreibberechtigung. Mit ihr können Sie festlegen, wie lange ADO auf die Ausführung eines Befehls wartet. Die Einstellung für die Eigenschaft CommandTimeout ist ein Wert in Sekunden, und der Standardwert beträgt 30. Eine Einstellung dieser Eigenschaft auf Null würde ADO erlauben, unbegrenzt auf die Ausführung des angegebenen Befehls zu warten. Bei einer Zeitüberschreitung eines Befehls wird ein Fehler generiert.

Die Eigenschaft CommandTimeout des Objekts Command hängt nicht mit der Eigenschaft CommandTimeout des Objekts Connection zusammen.

Für die Eigenschaft CommandTimeout des Connection-Objekts besteht selbst bei geöffnetem Connection-Objekt Lese- sowie Schreibberechtigung.

 
Hinweis

Nicht alle Provider unterstützen die Eigenschaft CommandTimeout.

 
Methode Connection.CommitTrans (Versionen 2.0, 2.1, 2.5 und 2.6)
 
s

Siehe Methode Connection.BeginTrans.

Ereignis Connection.CommitTransComplete (Versionen 2.0, 2.1, 2.5 und 2.6)

Private Sub CommitTransComplete(ByVal pError As ADODB.Error, _
adStatus As ADODB.EventStatusEnum, _
ByVal pConnection As ADODB.Connection)
 

Das Ereignis CommitTransComplete tritt ein, wenn die Methode CommitTrans ihre Operation abgeschlossen hat.

Argumente
pError

Ein Error-Objekt mit Detailangaben über einen aufgetretenen Fehler, sofern der Parameter adStatus auf adStatusErrorsOccurred gesetzt ist.

adStatus

Ein EventStatusEnum-Wert, der den Status der aktuellen Operation darstellt. Wenn der Parameter adStatus auf adStatusOK gesetzt ist, bedeutet dies, dass die Operation erfolgreich verlaufen ist. Weist der Parameter adStatus den Wert adStatusErrorsOccurred auf, so ist die Operation fehlgeschlagen, und das Objekt pError enthält genaue Auskunft über den Fehler. Indem Sie den Parameter adStatus auf adStatusUnwantedEvent setzen, wird dieses Ereignis nicht mehr aufgerufen.

pConnection

Das Connection-Objekt, das dieses Ereignis ausgelöst hat.

 
Siehe auch

Ereignis Connection.BeginTransComplete, Methode Connection.CommitTrans, Ereignis Connection.RollbackTransComplete, Enumeration EventStatusEnum

 
Ereignis Connection.ConnectComplete (Versionen 2.0, 2.1, 2.5 und 2.6)

Private Sub ConnectComplete(ByVal pError As ADODB.Error, _
adStatus As ADODB.EventStatusEnum, _
ByVal pConnection As ADODB.Connection)
 

Das Ereignis ConnectComplete tritt ein, sobald eine Verbindung hergestellt wurde.

Argumente
pError

Ein Error-Objekt mit Detailangaben über einen aufgetretenen Fehler, sofern der Parameter adStatus auf adStatusErrorsOccurred gesetzt ist.

adStatus

Ein EventStatusEnum-Wert, der den Status der aktuellen Operation darstellt. Wenn der Parameter adStatus auf adStatusOK gesetzt ist, bedeutet dies, dass die Operation erfolgreich verlaufen ist. Weist der Parameter adStatus den Wert adStatusErrorsOccurred auf, so ist die Operation fehlgeschlagen, und das Objekt pError enthält genaue Auskunft über den Fehler. Wenn Sie den Parameter adStatus auf adStatusUnwantedEvent setzen, wird dieses Ereignis nicht mehr aufgerufen.

pConnection

Das Connection-Objekt, das dieses Ereignis ausgelöst hat.

 
Siehe auch

Ereignis Connection.Disconnect, Ereignis Connection.WillConnect, Enumeration ConnectOptionEnum, Enumeration EventStatusEnum

 
Eigenschaft Connection.ConnectionString (Versionen 2.0, 2.1, 2.5 und 2.6)

connection.ConnectionString = connectionstring
 

Die Eigenschaft ConnectionString definiert die Verbindung für den Zugriff auf die Datenquelle.

Datentyp

String

 
Beschreibung

Die Eigenschaft ConnectionString gibt die Datenquelle an, auf die eine Verbindung zugreift. Es kann entweder ein DSN (Datenquellennamen) oder ein ausführlicher Verbindungsstring (eine Liste von Argumenten) übergeben werden. Die Argumente sind in der Form argument=value anzugeben, wobei mehrere Argumente mit Strichpunkt getrennt werden. Wenn ADO in der Eigenschaft ConnectionString auf ein Gleichheitszeichen stößt, wird davon ausgegangen, dass Sie einen ausführlichen Verbindungsstring übergeben.

 
Argumente

Unterstützt werden die drei nachfolgenden Argumente. Etwaige zusätzliche Argumente werden direkt an den Datenprovider übergeben und von ADO nicht berücksichtigt:

Provider

Gibt den Namen des für die bestimmte Verbindung zu verwendenden Datenproviders an.

Filename

Gibt den Namen einer für einen Datenprovider spezifischen Datei mit Verbindungsinformationen an. Dieses Argument und das Argument Provider schließen sich gegenseitig aus.

URL

Gibt die absolute URL einer Datei bzw. eines Verzeichnisses an.

Der Inhalt der Eigenschaft ConnectionString kann jederzeit nach dem Öffnen des Connection-Objekts von ADO geändert werden. Rufen Sie die Eigenschaft also ab, falls Sie sich über ihren Inhalt im Unklaren sein sollten.

Wenn das Argument ConnectionString in der Methode Open des Connection-Objekts verwendet wurde, wird der Wert in die Eigenschaft ConnectionString des Connection-Objekts geschrieben.

Bei geöffnetem Connection-Objekt ist ConnectionString schreibgeschützt, bei geschlossenem besteht sowohl Lese- als auch Schreibberechtigung.

 
Siehe auch

Methode Connection.Open

 
Eigenschaft Connection.ConnectionTimeout (Versionen 2.0, 2.1, 2.5 und 2.6)

connection.ConnectionTimeout = timeout
 

Die Eigenschaft ConnectionTimeout gibt in Sekunden an, wie lange ADO auf die Herstellung einer Verbindung zu einer Datenquelle wartet.

Datentyp

Long

 
Beschreibung

Mit der Eigenschaft ConnectionTimeout können Sie festlegen, wie lange ADO auf die Herstellung einer Verbindung zu einer Datenquelle wartet. Die Einstellung für die Eigenschaft ConnectionTimeout ist ein Wert in Sekunden. Eine Einstellung dieser Eigenschaft auf Null würde ADO erlauben, unbegrenzt auf die angegebene Verbindung zu warten. Bei Zeitüberschreitung der Verbindung wird ein Fehler generiert.

Bei geschlossenem Connection-Objekt besteht für die Eigenschaft ConnectionTimeout Lese- und Schreibberechtigung, bei geöffnetem ist sie schreibgeschützt.

 
Hinweis

Nicht alle Provider unterstützen die Eigenschaft ConnectionTimeout.

 
Siehe auch

Methode Connection.Open

 
Eigenschaft Connection.CursorLocation (Versionen 2.0, 2.1, 2.5 und 2.6)

connection.CursorLocation = CursorLocationEnum
 

Die Eigenschaft CursorLocation gibt die Adresse des Cursordienstes an.

Datentyp

CursorLocationEnum (Long)

 
Beschreibung

Der Wert der Eigenschaft CursorLocation kann auf einen der in Anhang E aufgeführten gültigen CursorLocationEnum-Werte gesetzt werden.

Für den Wert der Eigenschaft CursorLocation besteht sowohl Lese- als auch Schreibberechtigung. Eine Änderung des Werts dieser Eigenschaft wirkt sich jedoch nur auf Connection-Objekte aus, die nach der Änderung des Werts geöffnet werden.

 
Siehe auch

Methode Connection.Open

 
Eigenschaft Connection.DefaultDatabase (Versionen 2.0, 2.1, 2.5 und 2.6)

connection.DefaultDatabase = database
 

Die Eigenschaft DefaultDatabase bestimmt die für die aktuelle Verbindung als Standard gewählte Datenbank.

Datentyp

String

 
Beschreibung

Mit der Eigenschaft DefaultDatabase kann die Anwendung die Standarddatenbank für ein bestimmtes Connection-Objekt angeben.

Bei unbestimmter Syntax wird automatisch auf die mit der Eigenschaft DefaultDatabase angegebene Datenbank verwiesen. Für den Zugriff auf alle übrigen Datenbanken sind die Objektnamen durch die Namen der gewünschten Datenbanken genau zu bestimmen.

 
Hinweis

Nicht alle Provider unterstützen die Eigenschaft DefaultDatabase. In einem solchen Fall wird ein Fehler generiert oder ein leerer Stringwert zurückgegeben.

 
Ereignis Connection.Disconnect (Versionen 2.0, 2.1, 2.5 und 2.6)

Private Sub Disconnect(adStatus As ADODB.EventStatusEnum, _
ByVal pConnection As ADODB.Connection)
 

Das Ereignis Disconnect tritt ein, sobald eine Verbindung beendet wird.

Argumente
adStatus

Ein EventStatusEnum-Wert, der den Status der aktuellen Operation darstellt. Der Parameter adStatus wird beim Auslösen des Ereignisses stets auf adStatusOK gesetzt. Wenn Sie den Parameter adStatus vor Abschluss des Ereigniscodes auf adStatusUnwantedEvent setzen, wird dieses Ereignis nicht mehr aufgerufen.

pConnection

Das Connection-Objekt, das dieses Ereignis ausgelöst hat.

 
Siehe auch

Ereignis Connection.ConnectComplete, Enumeration EventStatusEnum

 
Kollektion Connection.Errors (Versionen 2.0, 2.1, 2.5 und 2.6)

Set errors = connection.Errors
 

Die Kollektion Errors ist eine Sammlung einzelner Fehler und Warnungen, die während der letzten Operation am aktuellen Connection-Objekt aufgetreten sind.

Datentyp

Fehler (Kollektionsobjekt)

 
Beschreibung

Die Eigenschaft Errors des Objekts Connection ist schreibgeschützt. Sie gibt einen Verweis auf das Kollektionsobjekt Errors zurück. Dieses kann Null oder zahlreiche Error-Objekte enthalten, die ADO- oder providerspezifische Fehler darstellen.

 
Methode Connection.Execute (Versionen 2.0, 2.1, 2.5 und 2.6)

connection.Execute CommandText, RecordsAffected, Options
Set recordset = connection.Execute(CommandText, RecordsAffected, Options)
 

Die Methode Execute dient zum Ausführen einer angegebenen SQL-Anweisung, Abfrage, gespeicherten Prozedur, URL oder eines providerspezifischen Befehls an der Datenquelle.

Argumente
CommandText (String)

Optional. Enthält die auszuführende SQL-Anweisung, Abfrage, gespeicherte Prozedur, URL bzw. den auszuführenden providerspezifischen Befehl. Der Parameter ist mit der Eigenschaft Command.CommandText vergleichbar.

RecordsAffected (Long)

Optional. Enthält die Anzahl der von dem ausgeführten Befehl betroffenen Datensätze.

Options (Long)

Optional. Stellt einen oder mehrere CommandTypeEnum- und ExecuteOptionEnum-Werte dar, die bestimmen, wie der Datenprovider den Befehl behandeln muss. Der Standardwert ist -1 (ohne gesetzte Optionen).

Die zulässigen Enumerationswerte für CommandTypeEnum und ExecuteOptionEnum sind in Anhang E aufgeführt.

 
Rückgabewerte

RecordsetObject

 
Beschreibung

Die Methode Execute führt den mit dem Parameter CommandText angegebenen Befehl aus, der wiederum auf Grundlage des Parameters Options ausgewertet wird. Ist die Befehlsausführung abgeschlossen, wird das Ereignis Connection.ExecuteComplete ausgelöst.

Wenn die Ausführung des Befehls Datensätze liefert, gibt die Methode Execute ein neues Recordset-Objekt zurück. Liefert die Ausführung des Befehls jedoch keine Datensätze, so gibt die Methode Execute ein leeres Recordset-Objekt zurück. In jedem Fall ist das zurückgegebene Recordset-Objekt aber schreibgeschützt und besitzt einen Forward-only-Cursor.

Enthält der Parameter Options der Methode Execute die Werte adAsyncExecute, adAsyncFetch oder adAsyncFetchNonBlocking, werden die Vorgänge im Hintergrund des Anwendungsflusses fortgesetzt. Während diese Vorgänge weiter laufen, kann die Methode Connection.Cancel aufgerufen werden, um alle anstehenden asynchronen Vorgänge abzubrechen.

 
Hinweis

In der Dokumentation zu ADO 2.6 (Beta 2) ist zu lesen, dass die CommandText-Argumente und -Eigenschaft auf eine relative URL gesetzt werden können. Tatsächlich aber erweist es sich als gleichgültig, auf was dieser Wert gesetzt wird. Wenn Sie den Inhalt eines Verzeichnisses abrufen möchten, müssen Sie das Verzeichnis in der Eigenschaft ConnectionString angeben. Was auch immer Sie als CommandText-Argumente für die Methode Execute oder die Eigenschaft CommandText angeben, wird ignoriert. Weisen Sie ihnen aber einen leeren String (") als Wert zu, erhalten Sie den Fehler "Errors Occured".

Das folgende Beispiel veranschaulicht, dass der Wert der Eigenschaft CommandText beim Aufruf der Methode Execute keine Rolle spielt:

Dim con As ADODB.Connection
Dim rec As ADODB.Recordset

Set con = New ADODB.Connection

con.Open "URL=http://jroff_laptop/"

Set rec = con.Execute("nothing really matters")
    
'
' rec contains contents of jroff_laptop
'

rec.Close
con.Close

Set rec = Nothing
Set con = Nothing
 
Siehe auch

Methode Connection.Cancel, Eigenschaft Command.CommandText, Ereignis Connection.ExecuteComplete, Enumeration CommandTypeEnum, Enumeration ExecuteOptionEnum

 
Ereignis Connection.ExecuteComplete (Versionen 2.0, 2.1, 2.5 und 2.6)

Private Sub con_ExecuteComplete(ByVal RecordsAffected As Long, _
ByVal pError As ADODB.Error, _
adStatus As ADODB.EventStatusEnum, _
ByVal pCommand As ADODB.Command, _
ByVal pRecordset As ADODB.Recordset, _
ByVal pConnection As ADODB.Connection)
 

Das Ereignis ExecuteComplete wird aufgerufen, wenn die Ausführung eines Befehls abgeschlossen ist.

Argumente
RecordsAffected (Long)

Gibt an, wie viele Datensätze von dem ausgeführten Befehl betroffen sind.

pError (Error)

Enthält Detailangaben über einen aufgetretenen Fehler, sofern der Parameter adStatus auf adStatusErrorsOccurred gesetzt ist.

adStatus (EventStatusEnum)

Gibt den Status der aktuellen Operation an. Wenn der Parameter adStatus auf adStatusOK gesetzt ist, bedeutet dies, dass die Operation erfolgreich verlaufen ist. Weist der Parameter adStatus den Wert adStatusErrorsOccurred auf, so ist die Operation fehlgeschlagen, und das Objekt pError enthält genaue Auskunft über den Fehler. Wenn Sie den Parameter adStatus auf adStatusUnwantedEvent setzen, wird dieses Ereignis nicht mehr aufgerufen.

pCommand

Stellt das ausgeführte Command-Objekt dar (sofern vorhanden).

pRecordset

Stellt das aus der Befehlsausführung resultierende Recordset-Objekt dar. Dieses Recordset-Objekt kann leer sein.

pConnection

Stellt das Connection-Objekt dar, das dieses Ereignis ausgelöst hat.

 
Siehe auch

Methode Connection.Execute, Methode Command.Execute, Methode Recordset.NextRecordset, Methode Recordset.Open, Enumeration EventStatusEnum

 
Ereignis Connection.InfoMessage (Versionen 2.0, 2.1, 2.5 und 2.6)

Private Sub InfoMessage(ByVal pError As ADODB.Error, _
adStatus As ADODB.EventStatusEnum, _
ByVal pConnection As ADODB.Connection)
 

Falls während einer ConnectionEvent-Operation eine Warnung auftritt, wird das Ereignis InfoMessage aufgerufen.

Argumente
pError

Ein Error-Objekt mit Detailangaben über einen aufgetretenen Fehler, sofern der Parameter adStatus auf adStatusErrorsOccurred gesetzt ist.

adStatus

Ein EventStatusEnum-Wert, der den Status der aktuellen Operation darstellt. Wenn der Parameter adStatus auf adStatusOK gesetzt ist, bedeutet dies, dass die Operation erfolgreich verlaufen ist. Weist der Parameter adStatus den Wert adStatusErrorsOccurred auf, so ist die Operation fehlgeschlagen, und das Objekt pError enthält genaue Auskunft über den Fehler. Wenn Sie den Parameter adStatus auf adStatusUnwantedEvent setzen, wird dieses Ereignis nicht mehr aufgerufen.

pRecordset

Das Recordset-Objekt, das dieses Ereignis ausgelöst hat.

 
Siehe auch

Enumeration EventStatusEnum

 
Eigenschaft Connection.IsolationLevel (Versionen 2.0, 2.1, 2.5 und 2.6)

connection.IsolationLevel = IsolationLevelEnum
 

Mit der Eigenschaft IsolationLevel legen Sie bei Verwendung einer Transaktionsverwaltung die Isolationsstufe fest.

Datentyp

IsolationLevelEnum (Long)

 
Beschreibung

Für die Eigenschaft IsolationLevel besteht Lese- und Schreibberechtigung. Eine Änderung des Werts dieser Eigenschaft wird erst beim Aufruf der Methode BeginTrans wirksam. Sollte der Datenprovider die gewünschte Isolationsstufe nicht gewährleisten können, wird automatisch die nächste Stufe eingestellt.

Die Eigenschaft IsolationLevel kann auf eine der in Anhang E aufgeführten IsolationLevelEnum-Enumerationen gesetzt werden.

 
Siehe auch

Methode Connection.BeginTrans, Enumeration IsolationLevelEnum

 
Eigenschaft Connection.Mode (Versionen 2.0, 2.1, 2.5 und 2.6)

connection.Mode = ConnectModeEnum
 

Die Eigenschaft Mode gibt die zum Ändern von Daten innerhalb der angegebenen Verbindung verfügbaren Berechtigungen an.

Datentyp

ConnectModeEnum (Long)

 
Beschreibung

Für die Eigenschaft Mode besteht bei geschlossenem Connection-Objekt sowohl Lese- als auch Schreibberechtigung, bei geöffnetem Objekt ist sie schreibgeschützt.

Die Eigenschaft Mode kann auf eine der in Anhang E aufgeführten ConnectModeEnum-Enumerationen gesetzt werden.

 
Methode Connection.Open (Versionen 2.0, 2.1, 2.5 und 2.6)

connection.Open ConnectionString, UserID, Password, Options
 

Die Methode Open für das Objekt Connection öffnet eine Verbindung zu einer bestimmten Datenquelle. Die Methode Open für das Objekt Recordset öffnet einen Cursor.

Argumente
ConnectionString (String)

Optional. Enthält die Informationen, die ADO für die Verbindung zum Datenprovider benötigt. Diese Eigenschaft ist der Eigenschaft Connection.ConnectionString zugeordnet.

UserID (String)

Optional. Enthält einen Benutzernamen für die Herstellung der gewünschten Verbindung.

Password (String)

Optional. Enthält ein Kennwort für die Herstellung der gewünschten Verbindung.

Options (Long)

Optional. Stellt einen ConnectOptionEnum-Enumerationswert dar. Der derzeit einzige definierte Wert für die Enumeration ConnectOptionEnum lautet adAsyncConnect (16). Er weist ADO an, eine asynchrone Verbindung zur Datenquelle herzustellen. Der Standardwert ist -1 (ohne gesetzte Optionen).

 
Beschreibung

Die Methode Open stellt eine Verbindung zu einem Datenprovider her. Sobald eine Verbindung hergestellt ist, können Sie Datenprovider-Befehle ausgeben und Informationen aus der Datenquelle abrufen.

Für einen asynchronen Verbindungsaufbau zum Datenprovider kann der Wert von adConnectAsync an den Parameter Options der Methode Open übergeben werden. Nach dem Start der Operation kann die Anwendung die Methode Connection.Cancel aufrufen, um die ausstehende asynchrone Verbindung abzubrechen, wenn sie festgestellt hat, dass der Verbindungsaufbau zu lange dauert.

Die Verbindung zum Datenprovider wird durch den Wert des Parameters ConnectionString bestimmt. Darüber hinaus werden Benutzer anhand der Parameter UserName und Password gegenüber dem Datenprovider authentifiziert. Die Werte für UserName und Password können sowohl in ConnectionString als auch in Form von Parametern der Methode Open festgelegt werden. In diesem Fall setzen die Parameter die in der Eigenschaft ConnectionString angegebenen Parameter außer Kraft.

Der Parameter ConnectionString setzt jegliche zuvor mit der Eigenschaft Connection.ConnectionString gesetzten Werte außer Kraft. Meistens enthält die Eigenschaft ConnectionString Informationen zur Verbindung, die zu ausführlich sind, als dass sie über den ConnectionString-Parameter der Methode Open übergeben werden sollten. Lesen Sie die Eigenschaft ConnectionString, um diese zusätzlichen Informationen zu sehen.

Wie die Eigenschaft ConnectionString besteht auch der Parameter ConnectionString aus einer Reihe von argument=value-Anweisungen, die durch Strichpunkte voneinander getrennt sind. Die innerhalb des Parameters (und der Eigenschaft) ConnectionString verwendeten Argumente sind vollkommen von dem Datenprovider abhängig, zu dem die Verbindung hergestellt wird.

Die Methode Connection.Close dient zum Schließen eines geöffneten Connection-Objekts, wenn es von der Anwendung nicht mehr benötigt wird. Ein geschlossenes Connection-Objekt kann geändert und erneut geöffnet werden. In Visual Basic entfernen Sie das Objekt Connection aus dem Speicher, indem Sie es auf Nothing setzen.

 
Siehe auch

Methode Connection.Cancel, Methode Connection.Close, Eigenschaft Connection.ConnectionString, Enumeration ConnectModeEnum, Enumeration ConnectOptionEnum

 
Connection.OpenSchema (Versionen 2.0, 2.1, 2.5 und 2.6)

Set recordset = connection.OpenSchema(Schema, Criteria, SchemaID)
 

Die Methode OpenSchema gibt ein Recordset-Objekt mit Informationen zum Schema der Datenquelle zurück.

Argumente
Schema (SchemaEnum)

Bestimmt, welchen Schementyp das nach Aufruf der Methode OpenSchema zurückgegebene Objekt Recordset liefert.

SchemaEnum enthält die in Tabelle F-1 aufgeführten Enumerationswerte.

Criteria (Varianten-Array)

Optional. Bestimmt, welche Beschränkungsspalten für das angeforderte Schema verwendet werden. In Tabelle G-1 finden Sie für jeden Schementyp eine Liste aller verfügbaren Beschränkungsspalten.

SchemaID (Long)

Optional. Stellt eine GUID einer providerspezifischen Schemenabfrage dar. Ist der Parameter Schema auf adSchemaProviderSpecific (-1) gesetzt, muss dieser Parameter angegeben werden. Anderenfalls wird er nicht verwendet.

 
Beschreibung

Die Methode OpenSchema dient zum Abrufen von Informationen über die Struktur, also das Schema, einer Datenquelle.

Durch Setzen des Parameters Schema auf einen SchemaEnum-Wert, kann ADO ermitteln, welche Information die Anwendung anfordert. Außerdem besteht die Möglichkeit, mit Hilfe des Parameters Criteria die Suche einzuschränken. Wird der Methode OpenSchema beispielsweise der Enumerationswert adSchemaTables übergeben, so gibt sie nur die Tabellennamen zurück.

Einige Provider unterstützen eigene Schemaabfragetypen. Wenn Sie dieses Leistungsmerkmal nutzen möchten, setzen Sie den Parameter Schema auf adSchemaProviderSpecific und den Parameter SchemaID auf die GUID der providerspezifischen Schemaabfrage. Wenn der Parameter Schema auf den Wert adSchemaProviderSpecific gesetzt und der Parameter SchemaID nicht angegeben ist, wird ein Fehler erzeugt.

Nicht alle Provider unterstützen sämtliche in Tabelle G-1 aufgeführten Schemaabfragen. Nur die Schemaabfragen adSchemaTables, adSchemaColumns und adSchemaProviderTypes werden von allen Providern unterstützt. Dies heißt aber nicht, dass eine Unterstützung der Beschränkungsspalten gewährleistet ist.

 
Siehe auch

Enumeration SchemaEnum

 
Kollektion Connection.Properties (Versionen 2.0, 2.1, 2.5 und 2.6)

Set properties = connection.Properties
 

Die Kollektion Properties enthält Eigenschaften, die für das Objekt Connection für den derzeit verwendeten Provider spezifisch sind.

Datentyp

Eigenschaften (Kollektionsobjekt)

 
Beschreibung

Die Kollektionsklasse Properties enthält für jede spezifisch auf das Command-Objekt des Datenproviders zutreffende Eigenschaft eine Instanz der Klasse Property.

Die Kollektion Properties des Objekts Connection enthält bis zum Öffnen des Connection-Objekts nur die folgenden Eigenschaften:

  • Password

  • Persist Security Info

  • User ID

  • Data Source

  • Window Handle

  • Location

  • Mode

  • Prompt

  • Connect Timeout

  • Extended Properties

  • Locale Identifier

  • Initial Catalog

  • OLE DB Services

  • General Timeout

 
Eigenschaft Connection.Provider (Versionen 2.0, 2.1, 2.5 und 2.6)

connection.Provider = provider
 

Die Eigenschaft Provider gibt dem aktuellen Connection-Objekt den Namen des anzusteuernden Datenproviders an.

Datentyp

String

 
Beschreibung

Die Eigenschaft Provider setzt den Provider für das aktuelle Connection-Objekt. Der Provider kann auch mit der Eigenschaft ConnectionString des Objekts Connection oder mit dem Argument ConnectionString an die Methode Open des Objekts Connection übergeben werden. Es empfiehlt sich jedoch, den Provider nur an einer dieser Stellen anzugeben, da die Ergebnisse sonst nicht vorhersehbar sind.

Für die Eigenschaft Provider des Objekts Connection besteht sowohl Lese- als auch Schreibberechtigung, während das zugehörige Connection-Objekt geschlossen ist. Bei geöffneter Connection ist es schreibgeschützt.

Die Eigenschaft Provider kommt erst zum Einsatz, wenn das Objekt Connection geöffnet oder die Kollektion Properties des Objekts Connection verwendet wird.

Ist kein Provider angegeben, steuert ADO standardmäßig MSDASQL, den Microsoft ODBC-Provider für OLE DB an.

 
Siehe auch

Eigenschaft Connection.ConnectionString, Methode Connection.Open

 
Methode Connection.RollbackTrans (Versionen 2.0, 2.1, 2.5 und 2.6)
 
s

Siehe Methode Connection.BeginTrans.

Ereignis Connection.RollbackTransComplete (Versionen 2.0, 2.1, 2.5 und 2.6)

Private Sub con_RollbackTransComplete(ByVal pError As ADODB.Error, _
adStatus As ADODB.EventStatusEnum, _
ByVal pConnection As ADODB.Connection)
 

Das Ereignis RollbackTransComplete wird ausgelöst, wenn die Methode RollbackTrans ihre Operation abgeschlossen hat.

Argumente
pError

Ein Error-Objekt mit Detailangaben über einen aufgetretenen Fehler, sofern der Parameter adStatus auf adStatusErrorsOccurred gesetzt ist.

adStatus

Ein EventStatusEnum-Wert, der den Status der aktuellen Operation darstellt. Wenn der Parameter adStatus auf adStatusOK gesetzt ist, bedeutet dies, dass die Operation erfolgreich verlaufen ist. Weist der Parameter adStatus den Wert adStatusErrorsOccurred auf, so ist die Operation fehlgeschlagen, und das Objekt pError enthält genaue Auskunft über den Fehler. Wenn Sie den Parameter adStatus auf adStatusUnwantedEvent setzen, wird dieses Ereignis nicht mehr aufgerufen.

pConnection

Das Connection-Objekt, das dieses Ereignis ausgelöst hat.

 
Siehe auch

Ereignis Connection.BeginTransComplete, Ereignis Connection.CommitTransComplete, Methode Connection.RollbackTrans, Enumeration EventStatusEnum

 
Eigenschaft Connection.State (Versionen 2.0, 2.1, 2.5 und 2.6)

state = connection.State
 

Die Eigenschaft State gibt den aktuellen Status eines Command-, Connection-, Record-, Recordset- oder Stream-Objekts an.

Datentyp

ObjectStateEnum (Long)

 
Beschreibung

Die Eigenschaft State gibt eine Kombination der in Anhang E aufgeführten Werte für ObjectStateEnum zurück, die den aktuellen Status eines Objekts anzeigen.

 
Siehe auch

Enumeration ObjectStateEnum

 
Eigenschaft Connection.Version (Versionen 2.0, 2.1, 2.5 und 2.6)

version = connection.Version
 

Die Eigenschaft Version gibt die derzeit verwendete ADO-Version an.

Datentyp

String

 
Beschreibung

Die Eigenschaft Version gibt die in Ihrer Anwendung verwendete ADO-Version in Form eines Strings zurück.

 
Ereignis Connection.WillConnect (Versionen 2.0, 2.1, 2.5 und 2.6)

Private Sub WillConnect(ConnectionString As String, _
UserID As String, _
Password As String, _
Options As Long, _
adStatus As ADODB.EventStatusEnum, _
ByVal pConnection As ADODB.Connection)
 

Das Ereignis WillConnect wird vor der Herstellung einer Verbindung ausgelöst.

Argumente
ConnectionString (String)

Enthält die Verbindungsinformationen für die ausstehende Verbindungsoperation.

UserID (String)

Enthält den Benutzernamen für die ausstehende Verbindungsoperation.

Password (String)

Enthält das Kennwort für die ausstehende Verbindungsoperation.

Options (Long)

Gibt an, wie der Parameter ConnectionString ausgewertet werden soll. Der einzig zulässige Wert für diesen Parameter lautet adAsyncOpen.

adStatus (EventStatusEnum)

Gibt den Status der aktuellen Operation an. Der Parameter adStatus wird dann auf adStatusOK gesetzt, wenn die das Ereignis auslösende Operation erfolgreich verlaufen ist. Ist der Parameter adStatus auf adStatusCantDeny gesetzt, so kann das Ereignis keinen Abbruch der Operation anfordern. Wenn Sie den Parameter adStatus auf adStatusUnwantedEvent setzen, wird dieses Ereignis nicht mehr aufgerufen. Ist der Parameter adStatus auf adStatusCancel gesetzt, erfolgt eine Abbruchanforderung für diese Operation.

pConnection

Stellt das Connection-Objekt dar, das dieses Ereignis ausgelöst hat.

 
Hinweis

Die Anwendung kann die Parameter ConnectionString, UserID und Password innerhalb dieses Ereignisses ändern, bevor die Operation fertig ausgeführt wird.

 
Siehe auch

Ereignis Connection.ConnectComplete, Enumeration EventStatusEnum

 
Ereignis Connection.WillExecute (Versionen 2.0, 2.1, 2.5 und 2.6)

Private Sub WillExecute(Source As String, _
CursorType As ADODB.CursorTypeEnum, _
LockType As ADODB.LockTypeEnum, _
Options As Long, _
adStatus As ADODB.EventStatusEnum, _
ByVal pCommand As ADODB.Command, _
ByVal pRecordset As ADODB.Recordset, _
ByVal pConnection As ADODB.Connection)
 

Das Ereignis WillExecute wird vor Beginn der Ausführung eines Befehls ausgelöst.

Argumente
Source (String)

Enthält die Quelle des Befehls, der ausgeführt werden soll. Dieser Wert ist in der Regel eine SQL-Anweisung oder der Name einer gespeicherten Prozedur (Aktionsabfrage).

CursorType (CursorTypeEnum)

Gibt die Art des Recordset-Objekts an, das geöffnet wird. Um die Art des Cursors zu ändern, der beim Aufruf der Methode Recordset.Open verwendet wird, kann dieser Wert innerhalb des Ereignisses geändert werden. Bei jeder anderen Methode, die dieses Ereignis auslöst, wird dieser Parameter ignoriert.

LockType (LockTypeEnum)

Gibt das Sperrschema an, das bei geöffnetem Recordset-Objekt verwendet wird. Um das Sperrschema zu ändern, das beim Aufruf der Methode Recordset.Open verwendet wird, kann dieser Wert innerhalb des Ereignisses geändert werden. Bei jeder anderen Methode, die dieses Ereignis auslöst, wird dieser Parameter ignoriert.

Options (Long)

Hiermit geben Sie etwaige weitere Optionen für die Ausführung des Befehls oder zum Öffnen des Datensatzes an.

adStatus (EventStatusEnum)

Gibt den Status der aktuellen Operation an. Der Parameter adStatus wird dann auf adStatusOK gesetzt, wenn die das Ereignis auslösende Operation erfolgreich verlaufen ist. Ist der Parameter adStatus auf adStatusCantDeny gesetzt, so kann das Ereignis keinen Abbruch der Operation anfordern. Wenn Sie den Parameter adStatus auf adStatusUnwantedEvent setzen, wird dieses Ereignis nicht mehr aufgerufen. Ist der Parameter adStatus auf adStatusCancel gesetzt, erfolgt eine Abbruchanforderung für diese Operation.

pCommand

Stellt das Objekt Command dar, auf das sich dieses Ereignis bezieht. Weist den Wert Nothing auf, wenn dieses Ereignis durch die Methode Connection.Execute oder Recordset.Open ausgelöst wurde.

pRecordset

Stellt das Objekt Recordset dar, auf das sich dieses Ereignis bezieht. Weist den Wert Nothing auf, wenn dieses Ereignis durch die Methode Connection.Execute oder Command.Execute ausgelöst wurde.

pConnection

Stellt das Connection-Objekt dar, das dieses Ereignis ausgelöst hat.

 
Siehe auch

Methode Connection.Execute, Methode Command.Execute, Methode Recordset.Open, Enumeration EventStatusEnum, Enumeration LockTypeEnum