Data.DB.TCustomConnection.OnLogin
Delphi
property OnLogin: TLoginEvent read FOnLogin write FOnLogin;
C++
__property Data::Dbcommontypes::TLoginEvent OnLogin = {read=FOnLogin, write=FOnLogin};
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| event | public | Data.DB.pas Data.DB.hpp |
Data.DB | TCustomConnection |
Beschreibung
Wird ausgelöst, wenn ein Kommunikationskanal zum Server geöffnet wird.
OnLogin wird beim Öffnen einer Verbindung ausgelöst, wenn die Eigenschaft LoginPrompt den Wert true hat.
Bei DataSnap-Verbindungskomponenten werden folgende Ereignisse generiert:
- Das Ereignis OnGetUsername wird ausgelöst. In der zugehörigen Routine kann ein Anfangswert für den Benutzernamen im Anmeldedialog übergeben werden.
- Es wird ein Anmeldedialog angezeigt, in dem der Benutzername und das Kennwort eingegeben werden können.
- Das Ereignis BeforeConnect wird ausgelöst, die Verbindung wird geöffnet, und das Ereignis AfterConnect wird generiert.
- Das Ereignis OnLogin wird ausgelöst. In der entsprechenden Routine können Sie mit Hilfe der im Remote-Anmeldedialog eingegebenen Informationen die Anmeldung auf dem Anwendungsserver durchführen.
Anmerkung: Verwenden Sie das Ereignis OnLogin nicht, wenn die Verbindungskomponente ein anderes Anmeldeschema bereitstellt. So verwendet beispielsweise TWebConnection stattdessen die Eigenschaften Username und Password.
Bei ADO-Verbindungskomponenten werden folgende Ereignisse generiert:
- Das Ereignis BeforeConnect wird ausgelöst.
- Das Ereignis OnWillConnect wird ausgelöst. Die Anwendung kann dann Anfangswerte für Benutzername und Passwort sowie für Verbindungsoptionen und Status bereitstellen.
- Es wird ein Anmeldedialog angezeigt, in dem der Benutzername und das Kennwort eingegeben werden können.
- Das Ereignis OnLogin wird ausgelöst. In der Behandlungsroutine können dann die Benutzereingaben bearbeitet werden (Sie können beispielsweise anwendungsspezifische Anmeldeinformationen in den Benutzernamen und das Passwort für die Datenbank konvertieren).
- Die Verbindung wird geöffnet, und das Ereignis AfterConnect wird ausgelöst.
Anmerkung: Einige Verbindungskomponenten, die keine Verbindung zum Anwendungsserver in einer mehrschichtigen Datenbankanwendung haben, ersetzen das OnLogin-Ereignis, das in TCustomConnection definiert ist, durch ein anderes Ereignis, das eintritt, bevor die Verbindung eingerichtet wird.