ValidatePasswordEventArgs.Cancel Vlastnost

Definice

Obor názvů:

System.Web.Security

Sestavení:

System.Web.ApplicationServices.dll

Získá nebo nastaví hodnotu, která označuje, zda aktuální akce create-user, change-password nebo reset-password bude zrušena.

public:
 property bool Cancel { bool get(); void set(bool value); };

public bool Cancel { get; set; }

member this.Cancel : bool with get, set

Public Property Cancel As Boolean

Hodnota vlastnosti

Boolean

truepokud bude zrušena aktuální akce create-user, change-password nebo reset-password; v opačném případě . false Výchozí formát je false.

Příklady

Následující příklad kódu ukazuje ValidatingPassword událost, která ověří formát hesla pro uživatele a zruší akci, pokud heslo neodpovídá požadovanému formátu.

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

Poznámky

Vlastnost Cancel slouží ke zrušení aktuální CreateUserakce , ChangePasswordnebo ResetPassword . Aktuální akci můžete zrušit nastavením Cancel vlastnosti na true během ValidatingPassword události.

Pokud aktuální akci zrušíte nastavením Cancel vlastnosti na true, můžete vlastnost nastavit FailureInformation na výjimku, která popisuje příčinu selhání ověření hesla. Metoda volání vyvolá výjimku, na FailureInformation kterou je vlastnost nastavena. FailureInformation Pokud je nullvlastnost , volající vyvolá obecnou výjimku selhání ověření hesla.

Viz také

• Úvod do ASP.NET členství