Bde.DBTables.TDBDataSet.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 TDBDataSet


Beschreibung

Schließt eine mit der Datenbanksitzung verbundene 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. Rufen Sie zum Freigeben von temporären Datenbankkomponenten nach dem Schließen der Verbindungen die Methode DropConnections der Session auf.

Siehe auch