Freigeben über

ValidatePasswordEventArgs.Cancel Eigenschaft

Definition

Namespace:
System.Web.Security
Assembly:
System.Web.dll
Assembly:
System.Web.ApplicationServices.dll

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die aktuelle Aktion "Benutzer erstellen", "Kennwort ändern" oder "Kennwort zurücksetzen" abgebrochen wird.

public:
 property bool Cancel { bool get(); void set(bool value); };
public bool Cancel { get; set; }
member this.Cancel : bool with get, set
Public Property Cancel As Boolean

Eigenschaftswert

Boolean

truewenn die aktuelle Aktion "Benutzer erstellen", "Kennwort ändern" oder "Kennwort zurücksetzen" abgebrochen wird; andernfalls . false Der Standardwert lautet 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 mit dem erforderlichen Format übereinstimmt.

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 CreateUserOder ChangePasswordResetPassword Aktion abzubrechen. Sie können die aktuelle Aktion abbrechen, indem Sie die Cancel Eigenschaft true während des Ereignisses ValidatingPassword 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 lautet null, löst der Aufrufer eine generische Ausnahme für die Kennwortüberprüfung aus.

Gilt für:

Weitere Informationen