ValidatePasswordEventArgs Klasse

Definition

Namespace:

System.Web.Security

Assembly:

System.Web.ApplicationServices.dll

Stellt Ereignisdaten für das ValidatingPassword-Ereignis der MembershipProvider-Klasse bereit.

public ref class ValidatePasswordEventArgs sealed : EventArgs

public sealed class ValidatePasswordEventArgs : EventArgs

type ValidatePasswordEventArgs = class
    inherit EventArgs

Public NotInheritable Class ValidatePasswordEventArgs
Inherits EventArgs

Vererbung

Object

EventArgs

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.

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, wenn die CreateUser- oder ChangePassword- ResetPassword Methode eines Mitgliedschaftsanbieters aufgerufen wird.

Sie können das ValidatingPassword Ereignis behandeln, um Kennwortformate und -werte für Benutzer der Mitgliedschaft zu überprüfen.

Sie können die aktuelle CreateUserAktion , ChangePasswordoder ResetPassword abbrechen, indem Sie die Cancel -Eigenschaft während des Ereignisses ValidatingPassword auf true festlegen.

Wenn Sie die aktuelle Aktion abbrechen, indem Sie die Cancel -Eigenschaft auf truefestlegen, können Sie die FailureInformation -Eigenschaft auf eine Ausnahme festlegen, die den Grund für den Fehler bei der Kennwortüberprüfung beschreibt. Die aufrufende Methode löst die Ausnahme aus, auf die die FailureInformation -Eigenschaft festgelegt ist. Wenn die FailureInformation -Eigenschaft ist null, löst der Aufrufer eine generische Fehlerfehler-Ausnahme für die Kennwortvalidierung aus.

Konstruktoren

ValidatePasswordEventArgs(String, String, Boolean)

Erstellt eine neue Instanz der ValidatePasswordEventArgs-Klasse.

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.
FailureInformation	Ruft eine Ausnahme ab, die den Grund für den Kennwortvalidierungsfehler beschreibt.
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.
Password	Ruft das Kennwort für die aktuelle Aktion zum Erstellen eines Benutzers, zum Ändern des Kennworts oder zum Zurücksetzen des Kennworts ab.
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.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• Einführung in ASP.NET Mitgliedschaft