ActiveConnection-Eigenschaft (ADO)

Gilt für: Access 2013, Office 2013

Gibt an, zu welchem Connection-Objekt das angegebene Command-, Recordset- oder Record-Objekt derzeit gehört.

Einstellungen und Rückgabewerte

Mit dieser Eigenschaft wird ein Wert vom Datentyp String zurückgegeben oder festgelegt, der eine Definition für eine Verbindung enthält, falls die Verbindung geschlossen ist, oder ein Wert vom Datentyp Variant, der das aktuelle Connection-Objekt enthält, falls die Verbindung geöffnet ist. Der Standard ist ein nullwertiger Objektverweis. Siehe ConnectionString-Eigenschaft.

Hinweise

Bestimmen Sie mithilfe der ActiveConnection-Eigenschaft das Connection-Objekt, über das das angegebene Command-Objekt ausgeführt oder das angegebene Recordset-Objekt geöffnet wird.

Befehl

Für Command-Objekte weist die ActiveConnection-Eigenschaft Lese-/Schreibzugriff auf.

Ein Fehler wird erzeugt, wenn Sie die Execute-Methode für ein Command-Objekt aufrufen, bevor Sie diese Eigenschaft auf ein geöffnetes Connection-Objekt oder eine gültige Verbindungszeichenfolge festgelegt haben.

Microsoft Visual Basic: Wenn Sie die ActiveConnection-Eigenschaft auf Nothing festlegen, wird das Command-Objekt von der aktuellen Connection getrennt und der Anbieter veranlasst, alle zugeordneten Ressourcen für die Datenquelle freizugeben. Sie können dann das Command-Objekt demselben oder einem anderen Connection-Objekt zuordnen. Einige Anbieter ermöglichen es, die Einstellung der Eigenschaft zwischen zwei Connection-Objekten zu ändern, ohne dass Sie die Eigenschaft zuerst auf Nothing festlegen müssen.

Wenn die Parameters-Auflistung des Command-Objekts vom Anbieter bereitgestellte Parameter enthält, wird die Auflistung gelöscht, falls Sie die ActiveConnection-Eigenschaft auf Nothing oder auf ein anderes Connection-Objekt festlegen. Wenn Sie Parameter-Objekte manuell erstellen und zum Füllen der Parameters-Auflistung des Command-Objekts verwenden, bleibt durch Festlegen der ActiveConnection-Eigenschaft auf Nothing oder auf ein anderes Connection-Objekt die Parameters-Auflistung unverändert.

Durch Schließen des Connection-Objekts, dem ein Command-Objekt zugeordnet ist, wird die ActiveConnection-Eigenschaft auf Nothing festgelegt. Ein Fehler wird generiert, wenn Sie diese Eigenschaft auf ein geschlossenes Connection-Objekt festlegen.

Recordset

Für geöffnete Recordset-Objekte oder für Recordset-Objekte, deren Source-Eigenschaft auf ein gültiges Command-Objekt festgelegt ist, ist die ActiveConnection-Eigenschaft schreibgeschützt. Andernfalls weist sie Lese-/Schreibzugriff auf.

Sie können für diese Eigenschaft ein gültiges Connection -Objekt oder eine gültige Verbindungszeichenfolge festlegen. In diesem Fall erstellt der Anbieter mithilfe dieser Definition ein neues Connection-Objekt und öffnet die Verbindung. Darüber hinaus kann der Anbieter diese Eigenschaft auf ein neues Connection-Objekt festlegen, um Ihnen eine Möglichkeit für den Zugriff auf das Connection-Objekt zu bieten, damit Sie erweiterte Fehlerinformationen abrufen oder andere Befehle ausführen können.

Wenn Sie das Argument ActiveConnection der Open-Methode zum Öffnen eines Recordset-Objekts verwenden, erbt die ActiveConnection-Eigenschaft den Wert des Arguments.

Wenn Sie die Source-Eigenschaft des Recordset-Objekts auf eine gültige Command-Objektvariable festlegen, erbt die ActiveConnection-Eigenschaft des Recordset-Objekts die Einstellung der ActiveConnection-Eigenschaft des Command-Objekts.

Remotedatendienstnutzung: Bei Verwendung in einem clientseitigen Recordset-Objekt kann diese Eigenschaft nur auf eine Verbindungszeichenfolge oder (in Microsoft Visual Basic oder Visual Basic, Scripting Edition) auf Nothing festgelegt werden.

Aufzeichnen

Diese Eigenschaft weist Lese-/Schreibzugriff auf, wenn das Record-Objekt geschlossen ist, und kann eine Verbindungszeichenfolge oder einen Verweis auf ein geöffnetes Connection-Objekt enthalten. Diese Eigenschaft ist schreibgeschützt, wenn das Record -Objekt geöffnet ist, und enthält einen Verweis auf ein geöffnetes Connection -Objekt.

Ein Connection -Objekt wird implizit erstellt, wenn das Record -Objekt über eine URL geöffnet wird. Öffnen Sie das Record-Objekt mit einem vorhandenen, geöffneten Connection-Objekt, indem Sie dem Connection-Objekt diese Eigenschaft zuweisen, oder mithilfe des Connection-Objekts als Parameter im Aufruf der Open-Methode. Wenn der Record aus einem vorhandenen Record- oder Recordset-Objekt geöffnet wird, wird er automatisch dem Connection-Objekt dieses Record- oder Recordset-Objekts zugeordnet.