ValidatePasswordEventArgs Classe

Definizione

Fornisce i dati per l'evento ValidatingPassword della classe MembershipProvider.Provides event data for the ValidatingPassword event of the MembershipProvider class.

public ref class ValidatePasswordEventArgs sealed : EventArgs
public sealed class ValidatePasswordEventArgs : EventArgs
type ValidatePasswordEventArgs = class
    inherit EventArgs
Public NotInheritable Class ValidatePasswordEventArgs
Inherits EventArgs
Ereditarietà
ValidatePasswordEventArgs

Esempio

Nell'esempio di codice seguente viene illustrato un evento ValidatingPassword che convalida il formato della password per l'utente e Annulla l'azione se la password non corrisponde al formato richiesto.The following code example shows a ValidatingPassword event that validates the format of the password for the user and cancels the action if the password does not match the required format.

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 metodo CreateUser, ChangePasswordo ResetPassword di un provider di appartenenze.The ValidatingPassword event is raised when the CreateUser, ChangePassword, or ResetPassword method of a membership provider is called.

È possibile gestire l'evento ValidatingPassword per convalidare i formati e i valori delle password per gli utenti di appartenenza.You can handle the ValidatingPassword event to validate password formats and values for membership users.

È possibile annullare l'azione CreateUser, ChangePasswordo ResetPassword corrente impostando la proprietà Cancel su true durante l'evento ValidatingPassword.You can cancel the current CreateUser, ChangePassword, or ResetPassword action by setting the Cancel property to true during the ValidatingPassword event.

Se si annulla l'azione corrente impostando la proprietà Cancel su true, è possibile impostare la proprietà FailureInformation su un'eccezione che descrive il motivo dell'errore di convalida della password.If you cancel the current action by setting the Cancel property to true, you can set the FailureInformation property to an exception that describes the reason for the password-validation failure. Il metodo chiamante genererà l'eccezione che la proprietà FailureInformation è impostata su.The calling method will throw the exception that the FailureInformation property is set to. Se la proprietà FailureInformation è null, il chiamante genererà un'eccezione generica di errore di convalida della password.If the FailureInformation property is null, the caller will throw a generic password-validation failure exception.

Costruttori

ValidatePasswordEventArgs(String, String, Boolean)

Crea una nuova istanza della classe ValidatePasswordEventArgs.Creates a new instance of the ValidatePasswordEventArgs class.

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.Gets or sets a value that indicates whether the current create-user, change-password, or reset-password action will be canceled.

FailureInformation

Ottiene o imposta un'eccezione che descrive il motivo dell'errore di convalida della password.Gets or sets an exception that describes the reason for the password-validation failure.

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).Gets a value that indicates whether the ValidatingPassword event is being raised during a call to the CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) method.

Password

Ottiene la password per l'azione corrente di creazione dell'utente, modifica della password o reimpostazione della password.Gets the password for the current create-user, change-password, or reset-password action.

UserName

Ottiene il nome dell'utente di appartenenza per l'azione corrente di creazione dell'utente, modifica della password o reimpostazione della password.Gets the name of the membership user for the current create-user, change-password, or reset-password action.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a

Vedi anche