Connection-Objekt | (Versionen 2.0, 2.1, 2.5 und 2.6) |
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 | |
|
|
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 | |
|
|
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 | |
|
|
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:
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 | |
|
|
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 | |
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
SchemaEnum enthält die in Tabelle F-1 aufgeführten Enumerationswerte.
|
|
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:
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
Siehe auch | |
Methode Connection.Execute, Methode Command.Execute, Methode Recordset.Open, Enumeration EventStatusEnum, Enumeration LockTypeEnum |
|