ValidatePasswordEventArgs Classe

Definizione

Spazio dei nomi:

System.Web.Security

Assembly:

System.Web.ApplicationServices.dll

Fornisce i dati per l'evento ValidatingPassword della classe MembershipProvider.

public ref class ValidatePasswordEventArgs sealed : EventArgs

public sealed class ValidatePasswordEventArgs : EventArgs

type ValidatePasswordEventArgs = class
    inherit EventArgs

Public NotInheritable Class ValidatePasswordEventArgs
Inherits EventArgs

Ereditarietà

Object

EventArgs

ValidatePasswordEventArgs

Esempio

Nell'esempio di codice seguente viene illustrato un ValidatingPassword evento che convalida il formato della password per l'utente e annulla l'azione se la password non corrisponde al formato richiesto.

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

Commenti

L'evento ValidatingPassword viene generato quando viene chiamato il CreateUsermetodo , ChangePasswordo ResetPassword di un provider di appartenenze.

È possibile gestire l'evento ValidatingPassword per convalidare i formati e i valori delle password per gli utenti di appartenenza.

È possibile annullare l'azione corrente , o impostando la Cancel proprietà su true durante l'eventoValidatingPassword.ResetPasswordChangePasswordCreateUser

Se si annulla l'azione corrente impostando la Cancel proprietà su true, è possibile impostare la FailureInformation proprietà su un'eccezione che descrive il motivo dell'errore di convalida della password. Il metodo chiamante genererà l'eccezione su cui è impostata la FailureInformation proprietà. Se la FailureInformation proprietà è null, il chiamante genererà un'eccezione di errore di convalida della password generica.

Costruttori

ValidatePasswordEventArgs(String, String, Boolean)

Crea una nuova istanza della classe ValidatePasswordEventArgs.

Proprietà

Cancel	Ottiene o imposta un valore che indica se verrà annullata l'operazione di creazione dell'utente, modifica della password o reimpostazione della password.
FailureInformation	Ottiene o imposta un'eccezione che descrive il motivo dell'errore di convalida della password.
IsNewUser	Ottiene un valore che indica se l'evento ValidatingPassword viene generato durante una chiamata al metodo CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus).
Password	Ottiene la password per l'azione corrente di creazione dell'utente, modifica della password o reimpostazione della password.
UserName	Ottiene il nome dell'utente di appartenenza per l'azione corrente di creazione dell'utente, modifica della password o reimpostazione della password.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• Introduzione all'appartenenza a ASP.NET