Bde.DBTables.TSession.FindDatabase
Delphi
function FindDatabase(const DatabaseName: string): TDatabase;
C++
TDatabase* __fastcall FindDatabase(const System::UnicodeString DatabaseName);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | Bde.DBTables.pas Bde.DBTables.hpp |
Bde.DBTables | TSession |
Description
Recherche la base de données spécifiée dans la liste des composants base de données de la session.
La méthode FindDatabase permet de déterminer si une base de données spécifique est associée à une session. DatabaseName indique le nom du composant base de données à rechercher.
FindDatabase compare DatabaseName à la propriété DatabaseName de chaque composant base de données dans la liste de la session. S'il existe une correspondance, FindDatabase renvoie un pointeur désignant le composant base de données. Sinon,FindDatabase renvoie nil (Delphi) ou NULL (C++).
Une application peut appeler FindDatabase pour vérifier si un composant base de données n'existe pas déjà avant d'en créer un nouveau pour la session.
var
DB: TDatabase;
begin
DB := Session.FindDatabase('DBDEMOS');
if (DB = nil) then { la base de données n'existe pas dans la session...}
DB := Session.OpenDatabase('DBDEMOS'); { La créeer et l'ouvrir }
if Assigned(DB) and DB.Active then begin
DB.StartTransaction;
...
end;
end;