Datenbankverbindungen schließen

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu Datenbanksitzungen verwalten - Index


Hinweis: Die Borland Database Engine (BDE) ist veraltet und wird nicht mehr weiterentwickelt. Die BDE wird Unicode beispielsweise nie unterstützen. Sie sollten mit der BDE keine neuen Entwicklungen vornehmen. Überprüfen Sie, ob Sie Ihre vorhandenen Datenbankanwendungen nicht von der BDE nach dbExpress migrieren können.

Zum Schließen einer einzelnen Datenbankverbindung rufen Sie die Methode CloseDatabase auf. Beim Aufruf von CloseDatabase wird der Referenzzähler der Datenbank, der sich beim Aufruf von OpenDatabase erhöht, um 1 herabgesetzt. Sobald der Referenzzähler für eine Datenbank auf 0 steht, wird die Datenbank geschlossen. CloseDatabase enthält einen Parameter, den Namen der Datenbank, die geschlossen werden soll. Wenn Sie die Datenbank mit der Methode OpenDatabase geöffnet haben, lässt sich dieser Parameter als Rückgabewert von OpenDatabase definieren.

Session.CloseDatabase(DBDemosDatabase);
Session->CloseDatabase(BCDemosDatabase);

Wenn der angegebene Datenbankname mit einer temporären (impliziten) Datenbankkomponente verbunden ist, und die Eigenschaft KeepConnections für diese Sitzung mit False definiert ist, wird die Datenbankkomponente freigegeben, wodurch die Verbindung geschlossen wird.

Hinweis: Ist KeepConnections gleich False, werden die temporären Datenbankkomponenten geschlossen und automatisch freigegeben, sobald die letzte mit der Datenbankkomponente verbundene Datenmenge geschlossen wird. Eine Anwendung kann die Methode CloseDatabase immer auch vor dieser Zeit aufrufen, um das Schließen zu initiieren. Um temporäre Datenbankkomponenten freizugeben, wenn für KeepConnections der Wert True eingestellt ist, rufen Sie die Methode Close der Datenbankkomponente auf und dann die Methode DropConnections der Sitzung.

Hinweis:  Der Aufruf von CloseDatabase für eine dauerhafte Datenbankkomponente bewirkt kein tatsächliches Schließen der Verbindung. Um die Verbindung wirklich zu schließen, müssen Sie die Methode Close der Datenbankkomponente direkt aufrufen.

Es gibt zwei Möglichkeiten, alle Datenbankverbindungen innerhalb einer Sitzung zu schließen:

  • Definieren Sie für die Eigenschaft Active dieser Sitzung den Wert False.
  • Rufen Sie die Methode Close für diese Sitzung auf.

Wenn Sie für Active den Wert False einstellen, ruft Delphi die Methode Close automatisch auf. Close trennt die Verbindung zu allen aktiven Datenbanken, indem sie die temporären Datenbankkomponenten freigibt und für jede dauerhafte Datenbankkomponente die Methode Close aufruft. Close definiert die BDE-Behandlung der Sitzung dann mit nil.

Siehe auch