ValidatePasswordEventArgs Класс

Определение

Предоставляет данные для события ValidatingPassword класса MembershipProvider.Provides event data for the ValidatingPassword event of the MembershipProvider class.

public ref class ValidatePasswordEventArgs sealed : EventArgs
public sealed class ValidatePasswordEventArgs : EventArgs
type ValidatePasswordEventArgs = class
    inherit EventArgs
Public NotInheritable Class ValidatePasswordEventArgs
Inherits EventArgs
Наследование
ValidatePasswordEventArgs

Примеры

В следующем примере кода показано ValidatingPassword событие, которое проверяет формат пароля для пользователя и отменяет действие, если пароль не соответствует требуемому формату.The following code example shows a ValidatingPassword event that validates the format of the password for the user and cancels the action if the password does not match the required format.

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

Комментарии

Событие возникает ChangePassword ResetPassword при вызове метода ,илипоставщикачленства.CreateUser ValidatingPasswordThe ValidatingPassword event is raised when the CreateUser, ChangePassword, or ResetPassword method of a membership provider is called.

Можно выполнить обработку ValidatingPassword события, чтобы проверить форматы и значения паролей для пользователей членства.You can handle the ValidatingPassword event to validate password formats and values for membership users.

Можно CreateUserотменить текущее ResetPassword ChangePassword действие,Cancel или, задав для true свойства значение во время события.ValidatingPasswordYou can cancel the current CreateUser, ChangePassword, or ResetPassword action by setting the Cancel property to true during the ValidatingPassword event.

Если вы отменяете текущее действие, задав Cancel для trueсвойства значение FailureInformation , можно присвоить свойству исключение, описывающее причину сбоя проверки пароля.If you cancel the current action by setting the Cancel property to true, you can set the FailureInformation property to an exception that describes the reason for the password-validation failure. Вызывающий метод выдаст исключение, FailureInformation для которого задано свойство.The calling method will throw the exception that the FailureInformation property is set to. Если свойство имеет nullзначение, вызывающий объект выдает исключение "Общая ошибка проверки пароля". FailureInformationIf the FailureInformation property is null, the caller will throw a generic password-validation failure exception.

Конструкторы

ValidatePasswordEventArgs(String, String, Boolean)

Создает новый экземпляр класса ValidatePasswordEventArgs.Creates a new instance of the ValidatePasswordEventArgs class.

Свойства

Cancel

Получает или задает значение, указывающее, будет ли отменено текущее действие по созданию пользователя, изменению пароля или сбросу пароля.Gets or sets a value that indicates whether the current create-user, change-password, or reset-password action will be canceled.

FailureInformation

Получает или задает исключение, которое описывает причину сбоя проверки пароля.Gets or sets an exception that describes the reason for the password-validation failure.

IsNewUser

Возвращает значение, показывающее вызывается ли событие ValidatingPassword при вызове метода CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus).Gets a value that indicates whether the ValidatingPassword event is being raised during a call to the CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) method.

Password

Возвращает пароль для текущих действий создания пользователя, изменения или сброса пароля.Gets the password for the current create-user, change-password, or reset-password action.

UserName

Возвращает имя пользователя членства для текущих действий создания пользователя, изменения или сброса пароля.Gets the name of the membership user for the current create-user, change-password, or reset-password action.

Методы

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Применяется к

Дополнительно