ValidatePasswordEventArgs ValidatePasswordEventArgs ValidatePasswordEventArgs ValidatePasswordEventArgs Class

定義

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
継承
ValidatePasswordEventArgsValidatePasswordEventArgsValidatePasswordEventArgsValidatePasswordEventArgs

次のコード例は、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イベントが発生したときに、 CreateUserChangePassword、または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.

現在をキャンセルするCreateUserChangePassword、または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. 呼び出し元のメソッドは、例外をスローする、FailureInformationプロパティに設定します。The calling method will throw the exception that the FailureInformation property is set to. 場合、FailureInformationプロパティはnull、呼び出し元が汎用のパスワード検証エラーの例外をスローします。If the FailureInformation property is null, the caller will throw a generic password-validation failure exception.

コンストラクター

ValidatePasswordEventArgs(String, String, Boolean) ValidatePasswordEventArgs(String, String, Boolean) ValidatePasswordEventArgs(String, String, Boolean) ValidatePasswordEventArgs(String, String, Boolean)

ValidatePasswordEventArgs クラスの新しいインスタンスを作成します。Creates a new instance of the ValidatePasswordEventArgs class.

プロパティ

Cancel Cancel Cancel Cancel

現在のユーザー作成、パスワード変更、またはパスワード リセットの各アクションをキャンセルするかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the current create-user, change-password, or reset-password action will be canceled.

FailureInformation FailureInformation FailureInformation FailureInformation

パスワード検証エラーの理由を説明する例外を取得または設定します。Gets or sets an exception that describes the reason for the password-validation failure.

IsNewUser IsNewUser IsNewUser 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 Password Password Password

現在のユーザー作成、パスワード変更、またはパスワード リセットの各アクションに対するパスワードを取得します。Gets the password for the current create-user, change-password, or reset-password action.

UserName UserName UserName UserName

現在のユーザー作成、パスワード変更、またはパスワード リセットの各アクションに対するメンバーシップ ユーザーの名前を取得します。Gets the name of the membership user for the current create-user, change-password, or reset-password action.

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

適用対象

こちらもご覧ください