ValidatePasswordEventArgs.FailureInformation Właściwość

Definicja

Przestrzeń nazw:

System.Web.Security

Zestaw:

System.Web.ApplicationServices.dll

Pobiera lub ustawia wyjątek opisujący przyczynę niepowodzenia weryfikacji hasła.

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

Wartość właściwości

Exception

Element Exception opisujący przyczynę niepowodzenia sprawdzania poprawności hasła.

Przykłady

Poniższy przykład kodu przedstawia ValidatingPassword zdarzenie, które weryfikuje format hasła użytkownika i anuluje akcję, jeśli hasło nie jest zgodne z wymaganym formatem.

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

Uwagi

Właściwość jest używana, gdy bieżąca CreateUserFailureInformation akcja , ChangePasswordlub ResetPassword została anulowana, ustawiając Cancel właściwość na true.

Właściwość jest ustawiona FailureInformation na wyjątek opisujący przyczynę niepowodzenia sprawdzania poprawności hasła. Metoda wywołująca zgłosi wyjątek, FailureInformation na który ustawiono właściwość . FailureInformation Jeśli właściwość ma nullwartość , obiekt wywołujący zgłosi ogólny wyjątek niepowodzenia weryfikacji hasła.

Zobacz też

• Wprowadzenie do członkostwa w ASP.NET