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

설명

ValidatingPassword 이벤트가 발생 경우를 CreateUser, ChangePassword, 또는 ResetPassword 멤버 자격 공급자의 메서드가 호출 됩니다.The 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, ChangePassword, 또는 ResetPassword 설정 하 여 작업을 Cancel 속성을 true 하는 동안는 ValidatingPassword 이벤트입니다.You 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. 호출 하는 메서드는 예외를 throw 하는 FailureInformation 속성입니다.The calling method will throw the exception that the FailureInformation property is set to. 경우는 FailureInformation 속성은 null를 호출자에 게 일반 암호 유효성 검사 오류가 예외를 throw 합니다.If 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)

적용 대상

추가 정보