ValidatePasswordEventArgs.Cancel Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
true
pokud 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 null
vlastnost , volající vyvolá obecnou výjimku selhání ověření hesla.