API:FireDAC.Comp.Client.TFDConnection.OnLogin
Delphi
property OnLogin: TFDConnectionLoginEvent read FOnLogin write FOnLogin;
C++
__property OnLogin;
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| event | published | FireDAC.Comp.Client.pas FireDAC.Comp.Client.hpp |
FireDAC.Comp.Client | TFDConnection |
Description
Se déclenche quand une application se connecte à un SGBD.
FireDAC.Comp.Client.TFDConnection.OnLogin hérite de FireDAC.Comp.Client.TFDCustomConnection.OnLogin. Tout le contenu en-dessous de cette ligne se réfère à FireDAC.Comp.Client.TFDCustomConnection.OnLogin.
Se déclenche quand une application se connecte à un SGBD.
Ecrivez un gestionnaire d'événement OnLogin pour prendre des actions spécifiques quand une application tente d'établir une connexion à un SGBD.
Quand la propriété LoginPrompt est définie sur True, une connexion de base de données est requise. L'événement OnLogin ou un dialogue de connexion apparaît seulement quand la propriété LoginPrompt est définie sur True. Le dialogue de connexion est présenté seulement si le gestionnaire d'événement OnLogin n'est pas assigné.
S'il n'y a pas de gestionnaire d'événement OnLogin, les valeurs User_Name, Password en cours et les autres paramètres sont lus à partir de la définition de connexion ou de la propriété Params, et un dialogue de connexion standard s'ouvre. Le dialogue vous invite à spécifier un nom d'utilisateur, un mot de passe et d'autres paramètres facultatifs, puis utilise les valeurs entrées par l'utilisateur pour définir User_Name, Password et les autres paramètres facultatifs dans la propriété Params. Ces valeurs sont ensuite passées au SGBD.
Les applications qui fournissent un gestionnaire d'événement OnLogin peuvent définir les valeurs User_Name, Password et les autres valeurs facultatives dans le paramètre AConnectionDef. AConnectionDef est une définition de connexion temporaire, qui est libérée automatiquement quand elle n'est plus nécessaire.
Un mot de passe fourni en utilisant un gestionnaire d'événement OnLogin ou un dialogue de connexion standard est effacé de la mémoire après la connexion. Un mot de passe fourni dans BeforeConnect n'est pas effacé.
Exemple
procedure TForm1.FDConnection1Login(AConnection: TFDCustomConnection; const AConnectionDef: IFDStanConnectionDef);
begin
AConnectionDef.UserName := 'dba';
AConnectionDef.Password := InputBox('Login', 'Please enter DBA password', 'sql');
end;
procedure TForm1.Button1Click(ASender: TObject);
begin
FDConnection1.OnLogin := FDConnection1Login;
FDConnection1.LoginPrompt := True;
FDConnection1.Connected := True;
end;