Bde.DBTables.TSession.CloseDatabase

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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.

Siehe auch