ValidatePasswordEventArgs Classe

Definição

Namespace:

System.Web.Security

Assembly:

System.Web.ApplicationServices.dll

Fornece dados de evento para o evento ValidatingPassword da classe MembershipProvider.

public ref class ValidatePasswordEventArgs sealed : EventArgs

public sealed class ValidatePasswordEventArgs : EventArgs

type ValidatePasswordEventArgs = class
    inherit EventArgs

Public NotInheritable Class ValidatePasswordEventArgs
Inherits EventArgs

Herança

Object

EventArgs

ValidatePasswordEventArgs

Exemplos

O exemplo de código a seguir mostra um ValidatingPassword evento que valida o formato da senha para o usuário e cancela a ação se a senha não corresponder ao formato necessário.

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

Comentários

O ValidatingPassword evento é gerado quando o CreateUsermétodo , ChangePasswordou ResetPassword de um provedor de associação é chamado.

Você pode manipular o ValidatingPassword evento para validar formatos de senha e valores para usuários associados.

Você pode cancelar a ação atual CreateUser, ChangePasswordou ResetPassword definindo a Cancel propriedade como true durante o ValidatingPassword evento.

Se você cancelar a ação atual definindo a Cancel propriedade como true, poderá definir a FailureInformation propriedade como uma exceção que descreve o motivo da falha de validação de senha. O método de chamada gerará a exceção à 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 senha.

Construtores

ValidatePasswordEventArgs(String, String, Boolean)

Cria uma nova instância da classe ValidatePasswordEventArgs.

Propriedades

Cancel	Obtém ou define um valor que indica se a ação atual de criar usuário, alterar senha ou redefinir senha será cancelada.
FailureInformation	Obtém ou define uma exceção que descreve o motivo da falha de validação de senha.
IsNewUser	Obtém um valor que indica se o evento ValidatingPassword está sendo gerado durante uma chamada para o método CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus).
Password	Obtém a senha da ação atual de criar usuário, alterar senha ou redefinir senha.
UserName	Obtém o nome de usuário associado da ação atual de criar usuário, alterar senha ou redefinir senha.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• Introdução à associação ASP.NET