Close-Methode (ADO)
Schließt ein geöffnetes Objekt und alle abhängigen Objekte.
Syntax
object.Close
Bemerkungen
Verwenden Sie die Close-Methode, um ein Connection, ein Record, ein Recordset-- oder ein Stream -Objekt zu schließen, um alle zugeordneten Systemressourcen freizugeben. Durch das Schließen eines Objekts wird es nicht aus dem Arbeitsspeicher entfernt. Sie können die Eigenschafteneinstellungen ändern und sie später erneut öffnen. Um ein Objekt vollständig aus dem Arbeitsspeicher zu entfernen, schließen Sie das Objekt, und legen Sie dann die Objektvariable auf Nothing (in Visual Basic) fest.
Verbindung
Mithilfe der Close-Methode zum Schließen eines Connection-Objekts werden auch alle aktiven Recordset- Objekte geschlossen, die der Verbindung zugeordnet sind. Ein Command-Objekt, das dem schließenden Connection-Objekt zugeordnet ist, bleibt erhalten, wird jedoch nicht mehr einem Connection-Objekt zugeordnet; d. h. die ActiveConnection-Eigenschaft wird auf Nothingfestgelegt. Darüber hinaus werden die Command-Objekts Parameters Auflistung aller vom Anbieter definierten Parameter gelöscht.
Sie können die Open-Methode später aufrufen, um die Verbindung mit derselben oder einer anderen Datenquelle erneut herzustellen. Während das Connection-Objekt geschlossen ist, wird beim Aufrufen aller Methoden, die eine offene Verbindung mit der Datenquelle erfordern, ein Fehler generiert.
Das Schließen eines Connection-Objekts, während Recordset-Objekt geöffnet ist, Objekte in der Verbindung alle ausstehenden Änderungen in allen Recordset--Objekten zurückgesetzt werden. Das explizite Schließen eines Connection-Objekts (aufrufen der Close-Methode), während eine Transaktion ausgeführt wird, wird ein Fehler generiert. Wenn ein Connection-Objekt außerhalb des Gültigkeitsbereichs liegt, während eine Transaktion ausgeführt wird, setzt ADO die Transaktion automatisch zurück.
Recordset, Record, Stream
Wenn Sie die Close-Methode verwenden, um ein Recordset, Recordoder Stream-Objekt zu schließen, werden die zugehörigen Daten freigegeben, und jeder exklusive Zugriff, den Sie möglicherweise über dieses bestimmte Objekt auf die Daten hatten. Sie können die Open-Methode später aufrufen, um das Objekt mit denselben attributen oder geänderten Attributen erneut zu öffnen.
Während ein Recordset-Objekt geschlossen ist, generiert das Aufrufen aller Methoden, die einen Livecursor erfordern, einen Fehler.
Wenn eine Bearbeitung während des sofortigen Updatemodus ausgeführt wird, generiert das Aufrufen der Close-Methode einen Fehler; Rufen Sie stattdessen zuerst die methode Update oder CancelUpdate auf. Wenn Sie das Recordset-objekt im Batchaktualisierungsmodus schließen, gehen alle Änderungen seit dem letzten UpdateBatch Aufruf verloren.
Wenn Sie die methode Clone verwenden, um Kopien eines geöffneten Recordset-Objekts zu erstellen, wirkt sich das Schließen des Originals oder eines Klons auf keine der anderen Kopien aus.
Gilt für
Siehe auch
Open- und Close-Methode (Vb-Beispiel)
Open- und Close-Methode (Beispiel) (VBScript)
Open- und Close-Methoden (Beispiel) (VC++)
Open-Methode (ADO-Verbindung)
Open-Methode (ADO-Recordset)
Save-Methode