ActiveConnection-Eigenschaft (ADO)

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

Einstellungen und Rückgabewerte

Legt fest oder gibt einen String -Wert, der eine Definition für eine Verbindung enthält, wenn die Verbindung geschlossen ist, oder einen Variant-Wert , der das aktuelle Connection -Objekt enthält, wenn die Verbindung geöffnet ist. Der Standardwert ist ein NULL-Objektverweis. Siehe die ConnectionString-Eigenschaft .

Bemerkungen

Verwenden Sie die ActiveConnection-Eigenschaft , um das Connection-Objekt zu bestimmen, über das das angegebene Command-Objekt ausgeführt wird oder das angegebene Recordset geöffnet wird.

Befehl

Bei Command-Objekten ist die ActiveConnection-Eigenschaft lese-/schreibgeschützt.

Wenn Sie versuchen, die Execute-Methode für ein Command-Objekt aufzurufen, bevor Sie diese Eigenschaft auf ein geöffnetes Connection-Objekt oder eine gültige Verbindungszeichenfolge festlegen, tritt ein Fehler auf.

Wenn der ActiveConnection-Eigenschaft ein Connection-Objekt zugewiesen ist, muss das Objekt geöffnet werden. Das Zuweisen eines geschlossenen Connection-Objekts verursacht einen Fehler.

Hinweis

Microsoft Visual Basic Durch Festlegen der ActiveConnection-Eigenschaft auf Nothing wird die Zuordnung des Command-Objekts von der aktuellen Verbindung getrennt und bewirkt, dass der Anbieter alle zugeordneten Ressourcen in der Datenquelle freigibt. Anschließend können Sie das Command-Objekt demselben oder einem anderen Connection-Objekt zuordnen. Einige Anbieter ermöglichen es Ihnen, die Eigenschaftseinstellung von einer Verbindung in eine andere zu ändern, ohne zuerst die Eigenschaft auf Nothing festlegen zu müssen.

Wenn die Parameters-Auflistung des Command-Objekts Parameter enthält, die vom Anbieter bereitgestellt werden, wird die Auflistung gelöscht, wenn Sie die ActiveConnection-Eigenschaft auf Nothing oder auf ein anderes Connection-Objekt festlegen. Wenn Sie Parameter-Objekte manuell erstellen und zum Ausfüllen der Parameters-Auflistung des Command-Objekts verwenden, bleibt die Parameters-Auflistung erhalten, wenn die ActiveConnection-Eigenschaft auf Nothing oder auf ein anderes Connection-Objekt festgelegt wird.

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

Recordset

Bei geöffneten Recordset-Objekten oder für Recordset-Objekte , deren Source-Eigenschaft auf ein gültiges Command-Objekt festgelegt ist, ist die ActiveConnection-Eigenschaft schreibgeschützt. Andernfalls handelt es sich um Lese-/Schreibzugriff.

Sie können diese Eigenschaft auf ein gültiges Connection-Objekt oder auf 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 das neue Connection-Objekt festlegen, damit Sie auf das Connection-Objekt zugreifen können, um erweiterte Fehlerinformationen zu erhalten oder andere Befehle auszuführen.

Wenn Sie das ActiveConnection-Argument der Open-Methode verwenden, um ein Recordset-Objekt zu öffnen, 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 die Einstellung der ActiveConnection-Eigenschaft des Command-Objekts.

Hinweis

Remote data Service Usage Wenn sie für ein clientseitiges Recordset-Objekt verwendet wird, kann diese Eigenschaft nur auf eine Verbindungszeichenfolge oder (in Microsoft Visual Basic oder Visual Basic, Scripting Edition) auf Nothing festgelegt werden.

Datensatz

Diese Eigenschaft ist lese-/schreibzugriff, wenn das Record-Objekt geschlossen wird, 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 einen Verweis auf ein geöffnetes Connection-Objekt enthält.

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