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 entreprendre des actions particulières lorsqu'une application tente de se connecter à un SGBD.
Quand la propriété LoginPrompt a la valeur True, une connexion de base de données est nécessaire. 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. La boîte de dialogue de connexion ne s'affiche que 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 transmises au SGBD.
Le gestionnaire d'événement de OnLogin reçoit les paramètres suivants :
AConnectionest le nom de la définition de connexion qui requiert les informations de connexion.AParamsdéfinit les paramètres de connexion.
Les applications qui fournissent un gestionnaire d'événement OnLogin peuvent remplir ou modifier les paramètres de connexion, comme AParams.UserName ou AParams.Password. AParams est un objet temporaire qui est libéré automatiquement lorsqu'il 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; AParams: TFDConnectionDefParams);
begin
AParams.UserName := 'dba';
AParams.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;