DBEngine.OpenConnection-Methode (DAO)

Gilt für: Access 2013, Office 2013

Syntax

Ausdruck . OpenConnection(Name, Options, ReadOnly, Connect)

Ausdruck Eine Variable, die ein DBEngine-Objekt darstellt.

Parameter

Name	Erforderlich/optional	Datentyp	Beschreibung
Name	Erforderlich	String	Ein Zeichenfolgenausdruck. Weitere Informationen erhalten Sie im Abschnitt "Hinweise".
Optionen	Optional	Variant	Legt verschiedene Optionen für die Verbindung fest, wie unter "Hinweise" beschrieben. Basierend auf diesem Wert fordert der ODBC-Treibermanager den Benutzer auf, Verbindungsdaten einzugeben, z. B. den Datenquellennamen (Data Source Name, DSN), den Benutzernamen oder das Kennwort.
ReadOnly	Optional	Variant	True, um die Verbindung nur mit Lesezugriff zu öffnen, und False, wenn die Verbindung mit Lese-/Schreibzugriff geöffnet werden soll (Standard).
Connect	Optional	Variant	Ein ODBC-Verbindungszeichenfolge. Die spezifischen Elemente und die Syntax dieser Zeichenfolge finden Sie in der Connect-Eigenschaft . Ein vorangestelltes "ODBC;" ist erforderlich.

Rückgabewert

Verbindung

Hinweise

Mit der OpenConnection-Methode können Sie aus einem ODBC-Arbeitsbereich eine Verbindung zu einer ODBC-Datenquelle herstellen. Die OpenConnection-Methode ähnelt der OpenDatabase-Methode. Der wichtigste Unterschied besteht darin, dass OpenConnection nur in einem ODBCDirect-Arbeitsbereich verfügbar ist.

Wenn Sie einen registrierten ODBC-Datenquellennamen (DSN) im connect-Argument angeben, kann das Argument name eine beliebige gültige Zeichenfolge sein und stellt auch die Name-Eigenschaft für das Connection-Objekt bereit. Wenn kein gültiger DSN im Connect-Argument enthalten ist, muss name auf einen gültigen ODBC-DSN verweisen, der auch die Name-Eigenschaft ist. Wenn weder name noch connect einen gültigen DSN enthält, kann der ODBC-Treiber-Manager (über das Optionsargument) festgelegt werden, um den Benutzer zur Eingabe der erforderlichen Verbindungsinformationen aufzufordern. Der durch die Eingabeaufforderung bereitgestellte DSN gibt dann die Name-Eigenschaft an.

Das Optionsargument bestimmt, ob und wann der Benutzer aufgefordert werden soll, die Verbindung herzustellen, und ob die Verbindung asynchron geöffnet werden soll. Sie können eine der folgenden Konstanten verwenden.

Konstante	Beschreibung
dbDriverNoPrompt	Der ODBC-Treibermanager verwendet die in dbname und connect angegebene Verbindungszeichenfolge. Es tritt ein Laufzeitfehler auf, wenn Sie nicht genügend Informationen bereitstellen.
dbDriverPrompt	Der ODBC-Treiber-Manager zeigt das Dialogfeld ODBC-Datenquellen an , in dem alle relevanten Informationen angezeigt werden, die in dbname oder connect angegeben werden. Die Verbindungszeichenfolge besteht aus dem DSN, den der Benutzer über die Dialogfelder auswählt, oder, wenn der Benutzer keinen DSN angibt, wird der Standard-DSN verwendet.
dbDriverComplete	Standard. Enthält das Argument connect alle für die Verbindung erforderlichen Informationen, verwendet der ODBC-Treibermanager die Zeichenfolge in connect. Andernfalls verhält er sich so, als hätten Sie dbDriverPrompt angegeben.
dbDriverCompleteRequired	Das Verhalten dieser Option entspricht dem von dbDriverComplete, mit der Ausnahme, dass der ODBC-Treiber die Eingabeaufforderungen für alle Informationen deaktiviert, die nicht für die Verbindung erforderlich sind.
dbRunAsync	Die Methode wird asynchron ausgeführt. Diese Konstante kann mit jeder anderen options-Konstante verwendet werden.

OpenConnection gibt ein Connection-Objekt zurück, das Informationen zur Verbindung enthält. Das Connection-Objekt ähnelt einem Database -Objekt. Der Hauptunterschied liegt darin, dass ein Database-Objekt in der Regel eine Datenbank repräsentiert, aber auch verwendet werden kann, um eine Verbindung zu einer ODBC-Datenquelle aus einem Microsoft Access-Arbeitsbereich darzustellen.