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 события.

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

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

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