Data.DB.TCustomConnection.LoginPrompt
Delphi
property LoginPrompt: Boolean read FLoginPrompt write FLoginPrompt default False;
C++
__property bool LoginPrompt = {read=FLoginPrompt, write=FLoginPrompt, default=0};
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| property | public | Data.DB.pas Data.DB.hpp |
Data.DB | TCustomConnection |
Description
Spécifie si une boîte de dialogue de connexion apparaît immédiatement avant l'ouverture d'une nouvelle connexion.
Définissez LoginPrompt à true pour fournir un support de connexion (login) lors de l'établissement de celle-ci. LoginPrompt contrôle deux choses : l'occurrence de l'événement OnLogin et l'aspect d'une boîte de dialogue de connexion par défaut qui demande aux utilisateurs de spécifier un nom et un mot de passe quand vous incluez DBLogDlg.hpp dans votre unité (C++) ou ajoutez DBLogDlg à votre clause uses (Delphi). Lorsque l'événement OnLogin se produit, l'apparition de la boîte de dialogue de connexion par défaut dépend du type du composant de connexion :
- Pour TDatabase, TIBDatabase et TSQLConnection, la boîte de dialogue apparaît après l'événement BeforeConnect et avant l'événement AfterConnect, à moins qu'un gestionnaire d'événement OnLogin ne soit fourni. S'il y a un gestionnaire d'événement OnLogin, cet événement survient à la place de la boîte de dialogue de connexion, et il n'est pas nécessaire d'inclure DBLogDlg.hpp dans votre unité (C++) ou d'ajouter DBLogDlg à votre clause uses (Delphi). Si les valeurs correctes pour le nom d'utilisateur et le mot de passe ne sont pas fournies dans la boîte de dialogue ou par le gestionnaire d'événement OnLogin, la connexion échoue. L'événement OnLogin ne se déclenche pas à moins que LoginPrompt soit initialisé à true.
- Pour des composants TADOConnection, la boîte de dialogue apparaît après l'événement OnWillConnect et avant l'événement BeforeConnect. S'il y a un gestionnaire d'événement OnLogin, cet événement survient après la boîte de dialogue de connexion. Si vous n'incluez pas DBLogDlg.hpp à votre unité (C++) ou si vous n'ajoutez pas DBLogDlg à votre clause uses (Delphi), l'événement OnLogin se produit mais aucune boîte de dialogue de connexion par défaut ne s'affiche. Si les valeurs correctes pour le nom d'utilisateur et le mot de passe ne sont pas fournies dans la boîte de dialogue ou par le gestionnaire d'événement OnLogin, la connexion échoue. L'événement OnLogin ne se déclenche pas à moins que LoginPrompt soit initialisé à true.
- Pour des composants DataSnap SOAP, la boîte de dialogue apparaît après l'événement OnGetUsername et avant les événements BeforeConnect, AfterConnect et OnLogin. Si l'utilisateur annule à partir de la boîte de dialogue, aucune tentative d'ouverture de connexion n'est faite.
Lorsque LoginPrompt est à false, l'application doit fournir les valeurs du nom d'utilisateur et du mot de passe par programmation :
- Pour TDatabase, le nom d'utilisateur et le mot de passe peuvent être fournis par les paramètres USER_NAME et PASSWORD de la propriété Params.
- Pour TADOConnection, le nom d'utilisateur et le mot de passe peuvent être fournis par la propriété ConnectionString.
- Pour TSQLConnection, le nom d'utilisateur, le mot de passe et la base de données peuvent être fournis par les paramètres UserName, Password et Database de la propriété Params, ou par les paramètres de connexion associés au nom de connexion.
- Pour les composants de connexion DataSnap SOAP, il n'y a pas d'incorporation utilisée pour le nom d'utilisateur et le mot de passe fournis par la boîte de dialogue de connexion. Les propriétés UserName et Password de TWebConnection sont sans rapport.
Avertissement : Le stockage en dur dans le code du nom d'utilisateur et du mot de passe ou dans le code pour un gestionnaire d'événement OnLogin peut compromettre la sécurité des serveurs.