MembershipValidatePasswordEventHandler デリゲートとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

MembershipValidatePasswordEventHandler デリゲート

メモ : このデリゲートは、.NET Framework version 2.0 で新しく追加されたものです。

MembershipProvider クラスの ValidatingPassword イベントを処理するメソッドを表します。

名前空間: System.Web.Security
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Delegate Sub MembershipValidatePasswordEventHandler
 ( _
    sender As Object, _
    e As ValidatePasswordEventArgs _
)

Visual Basic (使用法)

Dim instance As New MembershipValidatePasswordEventHandler(AddressOf
 HandlerMethod)

public delegate void MembershipValidatePasswordEventHandler
 (
    Object sender,
    ValidatePasswordEventArgs e
)

C++

public delegate void MembershipValidatePasswordEventHandler
 (
    Object^ sender, 
    ValidatePasswordEventArgs^ e
)

/** @delegate */
public delegate void MembershipValidatePasswordEventHandler
 (
    Object sender, 
    ValidatePasswordEventArgs e
)

JScript

JScript では、デリゲートは使用できますが、新規に宣言することはできません。

パラメータ

sender: ValidatingPassword イベントの発生元の MembershipProvider。

e: イベントデータを格納している ValidatePasswordEventArgs オブジェクト。

解説

MembershipValidatePasswordEventHandler デリゲートは、メンバシッププロバイダの ValidatingPassword イベントに対して定義されています。ValidatingPassword イベントは、メンバシッププロバイダの CreateUser、ChangePassword、または ResetPassword の各メソッドが呼び出されたときに発生します。

ValidatingPassword イベントを使用して、メンバシップユーザーのパスワードの形式と値を検証できます。

ValidatingPassword イベントで、ValidatePasswordEventArgs の Cancel プロパティを true に設定することにより、現在の CreateUser、ChangePassword、または ResetPassword の各アクションをキャンセルできます。

Cancel プロパティを true に設定して現在のアクションをキャンセルする場合、ValidatePasswordEventArgs の FailureInformation プロパティに、パスワード検証エラーの原因を説明する例外を設定できます。呼び出し元のメソッドは、FailureInformation プロパティに設定された例外をスローします。FailureInformation プロパティが null 参照 (Visual Basic では Nothing) である場合、呼び出し元は汎用パスワード検証エラー例外をスローします。

使用例

次のコード例に、ユーザーが入力したパスワードの形式を検証し、必要な形式と一致しない場合は処理をキャンセルする ValidatingPassword イベントを示します。

Visual Basic

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

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;
  }
}