ValidatePasswordEventArgs.FailureInformation Eigenschaft

Definition

Namespace:

System.Web.Security

Assembly:

System.Web.ApplicationServices.dll

Ruft eine Ausnahme ab, die den Grund für den Kennwortvalidierungsfehler beschreibt.

public:
 property Exception ^ FailureInformation { Exception ^ get(); void set(Exception ^ value); };

public Exception FailureInformation { get; set; }

member this.FailureInformation : Exception with get, set

Public Property FailureInformation As Exception

Eigenschaftswert

Exception

Eine Exception, die den Grund für den Kennwortvalidierungsfehler beschreibt.

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 FailureInformation -Eigenschaft wird verwendet, wenn die aktuelle CreateUserAktion , ChangePasswordoder ResetPassword abgebrochen wurde, indem die Cancel -Eigenschaft auf truefestgelegt wird.

Die FailureInformation -Eigenschaft ist auf eine Ausnahme festgelegt, 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.

Weitere Informationen

• Einführung in ASP.NET Mitgliedschaft