WebAdapt.TCustomLoginFormAdapter.OnValidatePassword

Übergeordnet: TCustomLoginFormAdapter

Delphi

property OnValidatePassword: TValidateAdapterFieldEvent read FOnValidatePassword write FOnValidatePassword;

C++

__property TValidateAdapterFieldEvent OnValidatePassword = {read=FOnValidatePassword, write=FOnValidatePassword};

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
event	public	WebAdapt.pas WebAdapt.hpp	WebAdapt	TCustomLoginFormAdapter

Beschreibung

Tritt auf, wenn der Adapter des Anmeldeformulars das vom Benutzer eingegebene Kennwort überprüft.

In einer Ereignisbehandlungsroutine für OnValidatePassword können Sie das vom Benutzer eingegebene Kennwort überprüfen. Das Ereignis ist besonders wichtig, wenn die WebSnap-Anwendung keine TWebUserList-Komponente verwendet, die Kennwörter und Benutzernamen prüft. Der Parameter Value der Ereignisbehandlungsroutine enthält das eingegebene Kennwort. Durch einen Lesezugriff auf die Eigenschaft UserName können Sie den dazugehörigen Benutzernamen abrufen.

Wenn die Aktion LogIn ausgeführt wird, empfängt der Adapter zuerst das Ereignis OnValidatePassword und prüft das Kennwort. Ist das Kennwort gültig, setzt die Ereignisbehandlungsroutine den Parameter Handled auf true. Der Adapter prüft nun den Benutzernamen (mit Hilfe des Ereignisses OnValidateUserName) und meldet den Benutzer an. Zur Anmeldung dient das Ereignis OnLogin (und, wenn die Anwendung einen Endbenutzeradapter enthält, ein Aufruf der Methode LogIn dieses Adapters). Ist das Kennwort ungültig, sollte die Ereignisbehandlungsroutine eine Exception auslösen. Wenn die Ereignisbehandlungsroutine das Kennwort nicht prüft, setzt sie den Parameter Handled auf false. In diesem Fall führt der Adapter des Anmeldeformulars eine Prüfung durch, die darin besteht, dass das Kennwort kein leerer String sein darf, wenn die Eigenschaft PasswordRequired true ist.