ActiveConnection-Eigenschaft (ADO)

Artikel
05/30/2023

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

Gibt den Schlüsseltyp an.

Legt fest oder gibt einen Zeichenfolgen-Wert zurück, der eine Definition für eine Verbindung enthält, wenn die Verbindung geschlossen wird, oder ein Variant-Objekt, das das aktuelle Connection-Objekt enthält, wenn die Verbindung geöffnet ist. Standard ist eine Null-Objektreferenz. Siehe die Eigenschaft ConnectionString.

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 wird geöffnet.

Befehl

Bei Command-Objekten ist die Eigenschaft ActiveConnection lesbar/schreibbar.

Versuchen Sie, die Execute-Methode für ein Command-Objekt aufzurufen, bevor Sie diese Eigenschaft auf ein offenes Connection-Objekt oder eine gültige Verbindungszeichenfolge setzen, tritt ein Fehler auf.

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

Hinweis

Microsoft Visual Basic Wenn Sie die ActiveConnection-Eigenschaft auf Nothing festlegen, wird das Command-Objekt 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 Einstellung der Eigenschaft von einer Connection zu einer anderen zu ändern, ohne dass Sie die Eigenschaft zunächst auf Nothing setzen müssen.

Wenn die Parameters-Sammlung des Command-Objekts vom Anbieter bereitgestellte Parameter enthält, wird die Sammlung gelöscht, wenn Sie die Eigenschaft ActiveConnection auf Nothing oder ein anderes Connection-Objekt setzen. Wenn Sie manuell Parameter-Objekte erstellen und diese zum Füllen der Parameters-Sammlung des Command-Objekts verwenden, bleibt die Parameter-Sammlung intakt, wenn Sie die Eigenschaft ActiveConnection auf Nothing oder ein anderes Connection-Objekt setzen.

Durch das Schließen des Connection-Objekts, mit dem ein Command-Objekt verknüpft ist, wird die Eigenschaft ActiveConnection auf Nothing gesetzt. Das Setzen dieser Eigenschaft auf ein geschlossenes Connection-Objekt erzeugt einen Fehler.

Recordset

Bei offenen Recordset-Objekten oder bei Recordset-Objekten, deren Eigenschaft Source auf ein gültiges Command-Objekt gesetzt ist, ist die Eigenschaft ActiveConnection schreibgeschützt. Andernfalls handelt es sich um einen 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 ein neues Connection-Objekt mit dieser Definition und öffnet die Verbindung. Darüber hinaus kann der Anbieter diese Eigenschaft auf das neue Connection-Objekt festlegen, damit Sie auf das Connection-Objekt für erweiterte Fehlerinformationen zugreifen oder andere Befehle ausführen können.

Wenn Sie das Argument ActiveConnection der Methode Open verwenden, um ein Recordset-Objekt zu öffnen, erbt die Eigenschaft ActiveConnection den Wert des Arguments.

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

Hinweis

Verwendung des Remotedatendiensts 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 enthält einen Verweis auf ein geöffnetes Connection-Objekt.

Ein Connection-Objekt wird implizit erstellt, wenn das Record-Objekt aus einer URL geöffnet wird. Öffnen Sie den Datensatz mit einem vorhandenen, öffnen Sie Connection-Objekt, indem Sie dieser Eigenschaft das Connection-Objekt zuweisen oder das Connection-Objekt als Parameter im Aufruf der Methode Open verwenden. Wenn der Datensatz aus einem vorhandenen Datensatz oder Recordset geöffnet wird, wird er automatisch mit dem Connection-Objekt dieses Datensatzes oder Recordsets verknüpft.