Språk

ValidatePasswordEventArgs.Cancel Egenskap

Definition

Hämtar eller anger ett värde som anger om den aktuella åtgärden create-user, change-password eller reset-password kommer att avbrytas.

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

Egenskapsvärde

trueom den aktuella åtgärden create-user, change-password eller reset-password avbryts. annars . false Standardvärdet är false.

Exempel

I följande kodexempel visas en ValidatingPassword händelse som verifierar lösenordets format för användaren och avbryter åtgärden om lösenordet inte matchar det format som krävs.

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

Kommentarer

Egenskapen Cancel används för att avbryta den aktuella CreateUseråtgärden , ChangePasswordeller ResetPassword . Du kan avbryta den aktuella åtgärden genom att ange egenskapen Cancel till true under ValidatingPassword händelsen.

Om du avbryter den aktuella åtgärden genom att ange Cancel egenskapen till truekan du ange FailureInformation egenskapen till ett undantag som beskriver orsaken till felet med lösenordsvalidering. Anropsmetoden utlöser undantaget som egenskapen är inställd på FailureInformation . Om egenskapen FailureInformation är nullutlöser anroparen ett allmänt undantag för lösenordsvalidering.

Gäller för

Se även