ValidatePasswordEventArgs.Cancel Vlastnost

Definice

Obor názvů:

System.Web.Security

Sestavení:

System.Web.ApplicationServices.dll

Získá nebo nastaví hodnotu, která určuje, zda bude aktuální akce vytvořit uživatele, změnit heslo nebo resetování hesla 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 se zruší aktuální akce vytvoření uživatele, změny hesla nebo resetování hesla; v opačném případě . false Výchozí hodnota 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 se používá ke zrušení aktuálního CreateUserobjektu , ChangePasswordnebo ResetPassword akce. Aktuální akci můžete zrušit nastavením Cancel vlastnosti true na během ValidatingPassword události.

Pokud zrušíte aktuální akci nastavením Cancel vlastnosti truena , můžete vlastnost nastavit FailureInformation na výjimku, která popisuje důvod selhání ověření hesla. Volající metoda vyvolá výjimku, na kterou FailureInformation je vlastnost nastavena. Pokud je FailureInformationnulltato vlastnost, volající vyvolá obecnou výjimku ověření hesla.

Viz také

• Úvod do členství v ASP.NET