ValidatePasswordEventArgs.FailureInformation Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.