ValidatePasswordEventArgs Classe

Definição

Namespace:

System.Web.Security

Assembly:

System.Web.ApplicationServices.dll

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

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 CreateUserChangePassword, ou ResetPassword método de um provedor de associação é chamado.

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

Você pode cancelar a ação ou a ResetPasswordChangePasswordação atual CreateUserdefinindo a Cancel propriedade 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 gerará uma exceção de falha de validação de senha genérica.

Construtores

Nome	Description
ValidatePasswordEventArgs(String, String, Boolean)	Cria uma nova instância da ValidatePasswordEventArgs classe.

Propriedades

Nome	Description
Cancel	Obtém ou define um valor que indica se a ação atual de create-user, change-password ou reset-password 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 ValidatingPassword evento está sendo gerado durante uma chamada para o CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) método.
Password	Obtém a senha da ação atual de criar usuário, alterar senha ou redefinir senha.
UserName	Obtém o nome do usuário associado para a ação atual create-user, change-password ou reset-password.

Métodos

Nome	Description
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 Objectatual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

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