MembershipValidatePasswordEventHandler Délégué

Définition

Représente la méthode qui gère l’événement ValidatingPassword de la classe MembershipProvider.Represents the method that will handle the ValidatingPassword event of the MembershipProvider class.

public delegate void MembershipValidatePasswordEventHandler(System::Object ^ sender, ValidatePasswordEventArgs ^ e);
public delegate void MembershipValidatePasswordEventHandler(object sender, ValidatePasswordEventArgs e);
type MembershipValidatePasswordEventHandler = delegate of obj * ValidatePasswordEventArgs -> unit
Public Delegate Sub MembershipValidatePasswordEventHandler(sender As Object, e As ValidatePasswordEventArgs)

Paramètres

sender
Object

MembershipProvider ayant déclenché l'événement ValidatingPassword.The MembershipProvider that raised the ValidatingPassword event.

e
ValidatePasswordEventArgs

Objet ValidatePasswordEventArgs qui contient les données d'événement.A ValidatePasswordEventArgs object that contains the event data.

Héritage
MembershipValidatePasswordEventHandler

Exemples

L’exemple de code suivant montre ValidatingPassword un événement qui valide le format du mot de passe pour l’utilisateur, puis annule l’action si le mot de passe ne correspond pas au format requis.The following code example shows a ValidatingPassword event that validates the format of the password for the user, and then 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

Remarques

Le MembershipValidatePasswordEventHandler délégué est défini pour l' ValidatingPassword événement pour un fournisseur d’appartenances.The MembershipValidatePasswordEventHandler delegate is defined for the ValidatingPassword event for a membership provider. L' ValidatingPassword événement est déclenché lorsque la CreateUser méthode, la ChangePassword méthode ou la ResetPassword méthode d’un fournisseur d’appartenances est appelée.The ValidatingPassword event is raised when the CreateUser method, the ChangePassword method, or the ResetPassword method of a membership provider is called.

Vous pouvez utiliser l' ValidatingPassword événement pour valider les formats et les valeurs de mot de passe pour les utilisateurs d’appartenance.You can use the ValidatingPassword event to validate password formats and values for membership users.

Vous pouvez annuler l’action CreateUseren ChangePasswordcours, ResetPassword ou en affectant Cancel à true la propriété du ValidatePasswordEventArgs fourni la valeur ValidatingPassword pendant l’événement.You can cancel the current CreateUser, ChangePassword, or ResetPassword action by setting the Cancel property of the supplied ValidatePasswordEventArgs to true during the ValidatingPassword event.

Si vous annulez l’action actuelle Cancel en affectant à truela propriété la valeur FailureInformation , vous pouvez affecter à ValidatePasswordEventArgs la propriété du fourni une exception qui décrit la raison de l’échec de la validation du mot de passe.If you cancel the current action by setting the Cancel property to true, you can set the FailureInformation property of the supplied ValidatePasswordEventArgs to an exception that describes the reason for the password-validation failure. La méthode d’appel lèvera l’exception pour laquelle FailureInformation la propriété a la valeur.The calling method will throw the exception that the FailureInformation property is set to. Si la FailureInformation propriété est null, l’appelant lève une exception d’échec de validation de mot de passe générique.If the FailureInformation property is null, the caller will throw a generic password-validation failure exception.

Méthodes d’extension

GetMethodInfo(Delegate)

Obtient un objet qui représente la méthode représentée par le délégué spécifié.Gets an object that represents the method represented by the specified delegate.

S’applique à

Voir aussi