MembershipValidatePasswordEventHandler デリゲート

.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)

C#

public delegate void MembershipValidatePasswordEventHandler
 (
    Object sender,
    ValidatePasswordEventArgs e
)

C++

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

J#

/** @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

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
System.Web.Security 名前空間
その他の技術情報
メンバシップの概要