ValidatePasswordEventArgs.FailureInformation Propriedade

Definição

Recebe ou define uma exceção que descreve a razão da falha na validação da palavra-passe.

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

Valor de Propriedade

E que descreve a razão da falha na Exception validação da palavra-passe.

Exemplos

O exemplo de código seguinte mostra um ValidatingPassword evento que valida o formato da palavra-passe para o utilizador e cancela a ação se a palavra-passe não corresponder ao formato exigido.

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

Observações

A FailureInformation propriedade é usada quando a ação atual CreateUser, ChangePassword, ou ResetPassword ação foi cancelada ao definir a Cancel propriedade para true.

A FailureInformation propriedade está definida como uma exceção que descreve a razão da falha da validação da palavra-passe. O método que chama lança a exceção para a qual a FailureInformation propriedade está definida. Se a FailureInformation propriedade for null, o chamador lançará uma exceção genérica de falha de validação de palavra-passe.

Aplica-se a

Ver também