Close-Methode (ADO)

Gilt für: Access 2013, Office 2013

Ein geöffnetes Objekt und alle abhängigen Objekte werden geschlossen.

Syntax

Objekt.Close

Hinweise

Verwenden Sie die Close-Methode, um ein Connection-, Record-, Recordset- oder 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 später erneut öffnen. Um ein Objekt vollständig aus dem Arbeitsspeicher zu entfernen, legen Sie die Objektvariable nach dem Schließen des Objekts auf Nothing (in Visual Basic) fest.

Connection

Beim Verwenden der Close-Methode zum Schließen eines Connection-Objekts werden auch alle der Verbindung zugeordneten Recordset-Objekte geschlossen. Ein Command-Objekt, das dem zu schließenden Connection-Objekt zugeordnet ist, bleibt permanent, ist jedoch nicht mehr einem Connection-Objekt zugeordnet, d. h., seine ActiveConnection-Eigenschaft wird auf Nothing festgelegt. Außerdem werden alle vom Anbieter definierten Parameter aus der Parameters-Auflistung des Command-Objekts gelöscht.

Später können Sie die Open-Methode aufrufen, um die Verbindung mit der gleichen oder einer anderen Datenquelle erneut herzustellen. Während das Connection -Objekt geschlossen ist, wird durch das Aufrufen von Methoden, die eine offene Verbindung mit der Datenquelle erfordern, ein Fehler generiert.

Durch das Schließen eines Connection -Objekts während geöffnete Recordset -Objekte für die Verbindung vorhanden sind, wird ein Rollback für ausstehende Änderungen in allen Recordset -Objekten ausgeführt. Durch das explizite Schließen eines Connection -Objekts (Aufrufen der Close -Methode) während einer ausgeführten Transaktion wird ein Fehler generiert. Wenn ein Connection -Objekt während einer ausgeführten Transaktion außerhalb des Bereichs liegt, wird von ADO automatisch ein Rollback für die Transaktion ausgeführt.

Recordset, Record, Stream

Beim Verwenden der Close -Methode zum Schließen der Objekte Recordset, Record oder Stream werden die zugeordneten Daten und jeder möglicherweise für Sie geltende exklusive Zugriff auf die Daten über das jeweilige Objekt freigegeben. Später können Sie die Open-Methode aufrufen, um das Objekt mit den gleichen oder geänderten Attributen erneut zu öffnen.

Während ein Recordset -Objekt geschlossen ist, wird durch das Aufrufen von Methoden, die einen Livecursor erfordern, ein Fehler generiert.

Wenn im Modus für sofortige Aktualisierungen eine Bearbeitung ausgeführt wird, wird durch Aufrufen der Close -Methode ein Fehler generiert; rufen Sie stattdessen erst 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 Clone-Methode zum Erstellen von Kopien eines geöffneten Recordset -Objekts verwenden, wirkt sich das Schließen des Originals oder eines Klons nicht auf andere Kopien aus.