Bde.DBTables.TDatabase.OnLogin
Delphi
property OnLogin: TDatabaseLoginEvent read FOnLogin write FOnLogin;
C++
__property TDatabaseLoginEvent OnLogin = {read=FOnLogin, write=FOnLogin};
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| event | published | Bde.DBTables.pas Bde.DBTables.hpp |
Bde.DBTables | TDatabase |
Beschreibung
Tritt ein, wenn eine Anwendung eine Verbindung zu einer Datenbank aufbaut.
Mithilfe einer Ereignisbehandlungsroutine für OnLogin können Sie bestimmte Aktionen definieren, die ausgeführt werden, wenn die Anwendung eine Verbindung zu einer Datenbank herstellt. Wenn die Eigenschaft LoginPrompt auf true gesetzt ist, ist eine Anmeldung erforderlich.
Wenn keine OnLogin-Ereignisbehandlungsroutine vorhanden ist, wird der aktuelle Benutzername (USERNAME) aus der Eigenschaft Params gelesen und ein Standard-Dialogfeld zur Anmeldung geöffnet. In diesem Dialogfeld wird der Benutzer zur Eingabe von Benutzername und Kennwort aufgefordert. Die eingegeben Werte werden dann zum Setzen der Werte von USERNAME und PASSWORD in der Eigenschaft Params verwendet. Anschließend werden diese Werte an den Remote-Server übergeben.
Anwendungen, in denen alternative Ereignisbehandlungsroutinen für OnLogin definiert wurden, müssen die Werte von USERNAME und PASSWORD in LoginParams festlegen. LoginParams ist eine temporäre String-Liste und wird automatisch freigegeben, wenn sie nicht mehr benötigt wird.
Anmerkung: Das Anmeldungsdialogfeld und das OnLogin-Ereignis treten nur auf, wenn die Eigenschaft LoginPrompt auf true gesetzt ist.