ValidatePasswordEventArgs.Cancel Свойство

Определение

Пространство имен:

System.Web.Security

Сборка:

System.Web.ApplicationServices.dll

Получает или задает значение, указывающее, будет ли отменено текущее действие по созданию пользователя, изменению пароля или сбросу пароля.

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

Значение свойства

Boolean

Значение true, если текущее действие по созданию пользователя, изменению пароля или сбросу пароля будет отменено;, в противном случае — значение false. Значение по умолчанию — false.

Примеры

В следующем примере кода показано ValidatingPassword событие, которое проверяет формат пароля для пользователя и отменяет действие, если пароль не соответствует требуемому формату.

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

Комментарии

Свойство Cancel используется для отмены текущего CreateUserдействия , ChangePasswordили ResetPassword . Текущее действие можно отменить, присвоив свойству Cancel значение true во время ValidatingPassword события.

Если отменить текущее действие, задав Cancel для свойства значение true, можно задать FailureInformation для свойства исключение, описывающее причину сбоя проверки пароля. Вызывающий метод вызовет исключение, FailureInformation для свойства задано значение . FailureInformation Если свойство имеет значение null, вызывающий объект вызовет исключение универсального сбоя проверки пароля.

См. также раздел

• Общие сведения о членстве ASP.NET