ValidatePasswordEventArgs Classe

Definição

Espaço de Nomes:
System.Web.Security
Assemblagem:
System.Web.dll
Assemblagem:
System.Web.ApplicationServices.dll

Fornece dados de eventos para o ValidatingPassword evento da MembershipProvider turma.

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 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

O ValidatingPassword evento é elevado quando o CreateUser, ChangePassword, ou ResetPassword método de um fornecedor de adesão é chamado.

Pode gerir o ValidatingPassword evento para validar formatos de palavra-passe e valores para utilizadores de membros.

Pode cancelar a ação atual CreateUser, ChangePassword, ou ResetPassword definindo a Cancel propriedade para true durante o ValidatingPassword evento.

Se cancelar a ação atual definindo a Cancel propriedade para true, pode definir a FailureInformation propriedade para uma exceção que descreva a razão da falha na 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.

Construtores

Name Description
ValidatePasswordEventArgs(String, String, Boolean)

Cria uma nova instância da ValidatePasswordEventArgs classe.

Propriedades

Name Description
Cancel

Recebe ou define um valor que indica se a ação atual de criar utilizador, alterar palavra-passe ou redefinir palavra-passe será cancelada.
FailureInformation

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

Recebe um valor que indica se o ValidatingPassword evento está a ser levantado durante uma chamada ao CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) método.
Password

Obtém a palavra-passe da ação atual de criar utilizador, alterar palavra-passe ou redefinir palavra-passe.
UserName

Obtém o nome do utilizador de membro para a ação atual de criar utilizador, alterar palavra-passe ou redefinir palavra-passe.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também