Bde.DBTables.TDatabase.OnLogin
Delphi
property OnLogin: TDatabaseLoginEvent read FOnLogin write FOnLogin;
C++
__property TDatabaseLoginEvent OnLogin = {read=FOnLogin, write=FOnLogin};
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| event | published | Bde.DBTables.pas Bde.DBTables.hpp |
Bde.DBTables | TDatabase |
Description
Se produit quand une application se connecte à une base de données.
Ecrivez un gestionnaire d'événement OnLogin pour entreprendre des actions particulières lorsqu'une application tente de se connecter à une base de données. Quand la propriété LoginPrompt a la valeur true, une connexion de base de données est nécessaire.
S'il n'existe pas de gestionnaire d'événement OnLogin, la valeur en cours de UserName est lue dans la propriété Params et la boîte de dialogue standard de connexion est ouverte. La boîte de dialogue demande un nom d'utilisateur et un mot de passe puis utilise les valeurs entrées par l'utilisateur pour définir les valeurs UserName et PASSWORD dans la propriété Params. Ces valeurs sont ensuite transmises au serveur distant.
Les applications qui fournissent des gestionnaires d'événements OnLogin de remplacement doivent définir les valeurs UserName et PASSWORD dans LoginParams. LoginParams est une liste de chaînes temporaire qui est libérée automatiquement quand elle n'est plus nécessaire.
Remarque : La boîte de dialogue de connexion et l'événement OnLogin ne se produisent que lorsque la propriété LoginPrompt a la valeur true.