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-, Record-, Recordset- oder Stream-Objekt zu schließen und alle zugeordneten Systemressourcen freizugeben. Durch das Schließen eines Objekts wird es nicht aus dem Arbeitsspeicher entfernt. Sie können seine Eigenschaftseinstellungen ändern und es später erneut öffnen. Wenn Sie ein Objekt vollständig aus dem Arbeitsspeicher entfernen möchten, schließen Sie das Objekt, und legen Sie dann die Objektvariable auf Nothing fest (in Visual Basic).

Verbindung

Wenn Sie ein Connection-Objekt mit der Close-Methode schließen, werden auch alle aktiven Recordset-Objekte geschlossen, die der Verbindung zugeordnet sind. Ein dem Connection-Objekt, das Sie schließen, zugeordnetes Command-Objekt bleibt erhalten, ist jedoch keinem Connection-Objekt mehr zugeordnet. Die ActiveConnection-Eigenschaft wird auf Nothing festgelegt. Außerdem werden alle vom Anbieter definierten Parameter aus der Parameters-Sammlung des Command-Objekts gelöscht.

Sie können später die Open-Methode aufrufen, um die Verbindung mit derselben oder einer anderen Datenquelle erneut herzustellen. Während das Connection-Objekt geschlossen ist, führen alle Aufrufe von Methoden, die eine geöffnete Verbindung mit der Datenquelle erfordern, zu einem Fehler.

Wenn ein Connection-Objekt geschlossen wird, während geöffnete Recordset-Objekte für die Verbindung vorhanden sind, werden ausstehende Änderungen in allen Recordset-Objekten zurückgesetzt. Das explizite Schließen eines Connection-Objekts (durch Aufrufen der Close-Methode), während eine Transaktion in Bearbeitung ist, führt zu einem Fehler. Wenn ein Connection-Objekt den Bereich verlässt, während eine Transaktion verarbeitet wird, setzt ActiveX Data Objects (ADO) die Transaktion automatisch zurück.

Recordset-, Record- und Stream-Objekt

Wenn Sie die Close-Methode verwenden, um ein Recordset-, Record- oder Stream-Objekt zu schließen, werden die zugeordneten Daten und ein exklusiver Zugriff auf die Daten, den Sie möglicherweise über dieses Objekt hatten, freigegeben. Sie können später die Open-Methode aufrufen, um das Objekt mit denselben oder geänderten Attributen erneut zu öffnen.

Während ein Recordset-Objekt geschlossen ist, führt das Aufrufen von Methoden, die einen Livecursor erfordern, zu einem Fehler.

Im Modus zur sofortigen Aktualisierung generiert das Aufrufen der Close-Methode einen Fehler, wenn zu diesem Zeitpunkt ein Bearbeitungsvorgang ausgeführt wird. Rufen Sie stattdessen zuerst die Update- oder CancelUpdate-Methode auf. Wenn Sie das Recordset-Objekt im Modus zur sofortigen Aktualisierung schließen, gehen alle Änderungen seit dem letzten UpdateBatch-Aufruf verloren.

Wenn Sie mit der Clone-Methode Kopien eines geöffneten Recordset-Objekts erstellen, wirkt sich das Schließen des ursprünglichen Recordsets oder eines Klons nicht auf die anderen Kopien aus.

Gilt für

Connection-Objekt (ADO)
Record-Objekt (ADO)

Recordset-Objekt (ADO)
Stream-Objekt (ADO)

Weitere Informationen

Open- und Close-Methode – Beispiel (VB)
Open- und Close-Methode – Beispiel (VBScript)
Open- und Close-Methode – Beispiel (VC++)
Open-Methode (ADO-Verbindung)
Open-Methode (ADO-Recordset)
Save-Methode