ValidatePasswordEventArgs.Cancel Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die aktuelle Aktion zum Erstellen eines Benutzers, zum Ändern des Kennworts oder zum Zurücksetzen des Kennworts abgebrochen wird.
public:
property bool Cancel { bool get(); void set(bool value); };public bool Cancel { get; set; }member this.Cancel : bool with get, setPublic Property Cancel As BooleanEigenschaftswert
true, wenn die aktuelle Aktion zum Erstellen eines Benutzers, zum Ändern des Kennworts oder zum Zurücksetzen des Kennworts abgebrochen wird, andernfalls false. Der Standardwert ist false.
Beispiele
Das folgende Codebeispiel zeigt ein ValidatingPassword Ereignis, das das Format des Kennworts für den Benutzer überprüft und die Aktion abbricht, wenn das Kennwort nicht dem erforderlichen Format entspricht.
public void Page_Load()
{
Membership.ValidatingPassword +=
new MembershipValidatePasswordEventHandler(OnValidatePassword);
}
public void OnValidatePassword(object sender,
ValidatePasswordEventArgs args)
{
System.Text.RegularExpressions.Regex r =
new System.Text.RegularExpressions.Regex(@"(?=.{6,})(?=(.*\d){1,})(?=(.*\W){1,})");
if (!r.IsMatch(args.Password))
{
args.FailureInformation =
new HttpException("Password must be at least 6 characters long and " +
"contain at least one number and one special character.");
args.Cancel = true;
}
}
Public Sub Page_Load()
AddHandler Membership.ValidatingPassword, _
New MembershipValidatePasswordEventHandler(AddressOf OnValidatePassword)
End Sub
Public Sub OnValidatePassword(sender As Object, _
args As ValidatePasswordEventArgs)
Dim r As System.Text.RegularExpressions.Regex = _
New System.Text.RegularExpressions.Regex("(?=.{6,})(?=(.*\d){1,})(?=(.*\W){1,})")
If Not r.IsMatch(args.Password) Then
args.FailureInformation = _
New HttpException("Password must be at least 6 characters long and " & _
"contain at least one number and one special character.")
args.Cancel = True
End If
End Sub
Hinweise
Die Cancel -Eigenschaft wird verwendet, um die aktuelle CreateUserAktion , ChangePasswordoder ResetPassword abzubrechen. Sie können die aktuelle Aktion abbrechen, indem Sie die Cancel -Eigenschaft während des Ereignisses ValidatingPassword auf true festlegen.
Wenn Sie die aktuelle Aktion abbrechen, indem Sie die Cancel -Eigenschaft auf truefestlegen, können Sie die FailureInformation -Eigenschaft auf eine Ausnahme festlegen, die den Grund für den Fehler bei der Kennwortüberprüfung beschreibt. Die aufrufende Methode löst die Ausnahme aus, auf die die FailureInformation -Eigenschaft festgelegt ist. Wenn die FailureInformation -Eigenschaft ist null, löst der Aufrufer eine generische Fehlerfehler-Ausnahme für die Kennwortvalidierung aus.
