Bde.DBTables.TDatabase.OnLogin

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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.

Siehe auch