Bde.DBTables.TSession.CloseDatabase
Delphi
procedure CloseDatabase(Database: TDatabase);
C++
void __fastcall CloseDatabase(TDatabase* Database);
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
procedure function |
public | Bde.DBTables.pas Bde.DBTables.hpp |
Bde.DBTables | TSession |
Beschreibung
Schließt eine der aktuellen Sitzung zugeordnete Datenbankverbindung.
Mit CloseDatabase können Sie eine dauerhafte Datenbankverbindung schließen oder eine temporäre Datenbankverbindung schließen und freigeben. In Database können Sie den Namen der Datenbankkomponente angeben, deren Verbindung geschlossen werden soll.
CloseDatabase verringert den Referenzzähler der angegebenen Datenbankkomponente. Wenn der Zähler den Wert Null erreicht und die Eigenschaft KeepConnection den Wert False besitzt, gibt CloseDatabase entweder die temporäre Datenbankkomponente frei oder schließt die Verbindung für eine persistente Datenbankkomponente.
Hinweis: Wird CloseDatabase auf eine dauerhafte Datenbankkomponente angewendet, wird die Verbindung nicht geschlossen. Um die Verbindung einer dauerhaften Datenbankkomponente zu schließen, rufen Sie die Methode Close der Datenbankkomponente direkt auf.
Temporäre Datenbankkomponenten werden automatisch geschlossen, wenn die letzte ihr zugeordnete Datenmenge geschlossen wird. Zuvor können Sie jedoch in einer Anwendung das Schließen mit CloseDatabase durchführen. Falls die Eigenschaft KeepConnections der Sitzung auf true (Standardwert) gesetzt wurde, wird die Komponente durch das Schließen einer für eine temporäre Datenbankkomponente eingerichteten Verbindung nicht freigegeben. Mit DropConnections können Sie die temporäre Datenbankkomponente freigeben, nachdem deren Verbindungen geschlossen wurden.