ValidatePasswordEventArgs.Cancel Właściwość

Definicja

Przestrzeń nazw:

System.Web.Security

Zestaw:

System.Web.ApplicationServices.dll

Pobiera lub ustawia wartość wskazującą, czy bieżąca akcja create-user, change-password lub reset-password zostanie anulowana.

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

Wartość właściwości

Boolean

true jeśli bieżąca akcja create-user, change-password lub reset-password zostanie anulowana; w przeciwnym razie, false. Wartość domyślna to false.

Przykłady

Poniższy przykład kodu przedstawia ValidatingPassword zdarzenie, które weryfikuje format hasła użytkownika i anuluje akcję, jeśli hasło nie jest zgodne z wymaganym formatem.

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

Uwagi

Właściwość Cancel jest używana do anulowania bieżącej CreateUserakcji , lub ChangePasswordResetPassword . Bieżącą akcję można anulować, ustawiając Cancel właściwość na true wartość podczas ValidatingPassword zdarzenia.

Jeśli anulujesz bieżącą akcję, ustawiając Cancel właściwość na true, możesz ustawić FailureInformation właściwość na wyjątek opisujący przyczynę niepowodzenia weryfikacji hasła. Metoda wywołująca zgłosi wyjątek, na który FailureInformation ustawiono właściwość . FailureInformation Jeśli właściwość to null, obiekt wywołujący zgłosi ogólny wyjątek niepowodzenia weryfikacji hasła.

Zobacz też

• Wprowadzenie do członkostwa ASP.NET