Sitzung aktivieren

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.

Active ist eine Boolesche Eigenschaft, die festlegt, ob die mit einer Sitzung verbundene Datenbank und die Datenmengenkomponenten geöffnet sind. Diese Eigenschaft lässt sich dazu verwenden, den aktuellen Verbindungsstatus der Sitzungsdatenbank und der Datenmengen abzulesen oder diesen zu ändern. Ist für Active die Standardoption False eingestellt, werden alle Datenbanken und Datenmengen, die mit dieser Sitzung verbunden sind, geschlossen. Ist True eingestellt, sind die Datenbanken und Datenmengen geöffnet.

Eine Sitzung wird unmittelbar bei ihrer Erstellung aktiviert und später, wenn für die Eigenschaft Active anstelle von False True eingestellt wird (z.B.: sobald eine Datenbank oder eine Datenmenge, die mit einer Sitzung verbunden ist, geöffnet wird und aktuell keine anderen Datenbanken oder Datenmengen offen sind). Wird Active auf True gesetzt, wird das Sitzungsereignis Bde.DBTables.TSession.OnStartup ausgelöst, die Paradox-Verzeichnisse bei der BDE registriert und die Eigenschaft ConfigMode ermittelt, die festlegt, welche BDE-Aliasnamen in dieser Sitzung verfügbar sind. Sie können eine OnStartup-Ereignisbehandlungsroutine schreiben, um die Eigenschaften NetFileDir, PrivateDir und ConfigMode zu initialisieren, ehe diese von der BDE registriert werden, oder um andere sitzungsspezifische Startaktivitäten durchzuführen.

Ist eine Sitzung aktiv, können Sie deren Datenbankverbindungen öffnen, indem Sie die Methode OpenDatabase aufrufen.

Für Sitzungskomponenten fügen Sie ein Datenmodul oder Formular ein; durch die Einstellung von Active auf False schließen Sie eventuell geöffnete Datenbanken oder Datenmengen. Während der Laufzeit kann das Schließen von Datenbanken und Datenmengen Ereignisse auslösen, die mit diesen verbunden sind.

Hinweis: Sie können die Eigenschaft Active für das Standardsitzungsobjekt während des Anwendungsentwurfs nicht auf False einstellen. Es ist zwar möglich, die Standardsitzung während der Laufzeit zu schließen, aber nicht empfehlenswert.

Auch die Methoden Open und Close einer Sitzung lassen sich dazu verwenden, während der Laufzeit andere Sitzungen als die Standardsitzung zu aktivieren oder zu deaktivieren. Beispiel: Mit der folgenden einzigen Codezeile können Sie alle geöffneten Datenbanken und Datenmengen schließen:

Delphi:

Session1.Close;

C++:

Session1->Close();

Dieser Code setzt die Eigenschaft Active von Session1 auf False. Ist die Eigenschaft Active einer Sitzung mit False eingestellt, stellt jeder nachfolgende Versuch der Anwendung, eine Datenbank oder Datenmengen zu öffnen, die Eigenschaft Active wieder auf True und ruft die Ereignisbehandlung OnStartup der Sitzung auf, sofern diese vorhanden ist. Sie können auch die Reaktivierung einer Sitzung während der Laufzeit explizit codieren. Der folgende Code reaktiviert Session1:

Delphi:

Session1.Open;

C++:

Session1->Open();

Hinweis: Ist eine Sitzung aktiv, lassen sich einzelne Datenbankverbindungen öffnen und schließen. Nähere Informationen finden Sie unter Datenbankverbindungen schließen.

Siehe auch