ValidatePasswordEventArgs.Cancel Свойство

Определение

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

System.Web.Security

Сборка:

System.Web.ApplicationServices.dll

Возвращает или задает значение, указывающее, будет ли отменено текущее действие create-user, change-password или reset-password.

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 Значение , если текущее действие create-user, change-password или reset-password будет отменено; 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 используется для отмены текущего CreateUserChangePasswordили ResetPassword действия. Текущее действие можно отменить, задав Cancel для свойства значение true во время ValidatingPassword события.

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

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

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