ValidatePasswordEventArgs Klasse

Definition

Stellt Ereignisdaten für das ValidatingPassword-Ereignis der MembershipProvider-Klasse bereit.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
Vererbung
ValidatePasswordEventArgs

Beispiele

Das folgende Codebeispiel zeigt ein ValidatingPassword -Ereignis, das das Format des Kennworts für den Benutzer überprüft und die Aktion abbricht, wenn das Kennwort nicht dem erforderlichen Format entspricht.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

Hinweise

Das ValidatingPassword -Ereignis wird ausgelöst, CreateUserWenn ChangePassworddie- ResetPassword ,-oder-Methode eines Mitgliedschafts Anbieters aufgerufen wird.The ValidatingPassword event is raised when the CreateUser, ChangePassword, or ResetPassword method of a membership provider is called.

Sie können das ValidatingPassword -Ereignis behandeln, um Kenn Wort Formate und-Werte für Mitgliedschafts Benutzer zu überprüfen.You can handle the ValidatingPassword event to validate password formats and values for membership users.

CreateUserSie können die aktuelle-,-oder ResetPassword -Aktion abbrechen, Cancel ChangePasswordindem Sie die- ValidatingPassword Eigenschaft während des-Ereignisses auf true festlegen.You can cancel the current CreateUser, ChangePassword, or ResetPassword action by setting the Cancel property to true during the ValidatingPassword event.

Wenn Sie die aktuelle Aktion abbrechen, indem Sie Cancel die- trueEigenschaft auf festlegen, können FailureInformation Sie die-Eigenschaft auf eine Ausnahme festlegen, die den Grund für den Fehler bei der Kenn Wort Validierung beschreibt.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. Die Aufruf Methode löst die Ausnahme aus, auf FailureInformation die die-Eigenschaft festgelegt ist.The calling method will throw the exception that the FailureInformation property is set to. Wenn die FailureInformation -Eigenschaft nullist, löst der Aufrufer eine Fehler Ausnahme bei der allgemeinen Kenn Wort Überprüfung aus.If the FailureInformation property is null, the caller will throw a generic password-validation failure exception.

Konstruktoren

ValidatePasswordEventArgs(String, String, Boolean)

Erstellt eine neue Instanz der ValidatePasswordEventArgs-Klasse.Creates a new instance of the ValidatePasswordEventArgs class.

Eigenschaften

Cancel

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die aktuelle Aktion zum Erstellen eines Benutzers, zum Ändern des Kennworts oder zum Zurücksetzen des Kennworts abgebrochen wird.Gets or sets a value that indicates whether the current create-user, change-password, or reset-password action will be canceled.

FailureInformation

Ruft eine Ausnahme ab, die den Grund für den Fehler bei der Kennwortvalidierung beschreibt, oder legt diese Ausnahme fest.Gets or sets an exception that describes the reason for the password-validation failure.

IsNewUser

Ruft einen Wert ab, der angibt, ob das ValidatingPassword-Ereignis während eines Aufrufs der CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)-Methode ausgelöst wird.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

Ruft das Kennwort für die aktuelle Aktion zum Erstellen eines Benutzers, zum Ändern des Kennworts oder zum Zurücksetzen des Kennworts ab.Gets the password for the current create-user, change-password, or reset-password action.

UserName

Ruft den Namen des Mitgliedschaftsbenutzers für die aktuelle Aktion zum Erstellen eines Benutzers, zum Ändern des Kennworts oder zum Zurücksetzen des Kennworts ab.Gets the name of the membership user for the current create-user, change-password, or reset-password action.

Methoden

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch