ValidatePasswordEventArgs クラス

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

ValidatePasswordEventArgs クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

MembershipProvider クラスの ValidatingPassword イベントのイベント データを提供します。

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

Visual Basic (宣言)

Public NotInheritable Class
 ValidatePasswordEventArgs
    Inherits EventArgs

Visual Basic (使用法)

Dim instance As ValidatePasswordEventArgs

C#

public sealed class ValidatePasswordEventArgs
 : EventArgs

C++

public ref class ValidatePasswordEventArgs
 sealed : public EventArgs

J#

public final class ValidatePasswordEventArgs
 extends EventArgs

JScript

public final class ValidatePasswordEventArgs
 extends EventArgs

解説

ValidatingPassword イベントは、メンバシップ プロバイダの CreateUser、ChangePassword、または ResetPassword の各メソッドが呼び出されたときに発生します。

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

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

Cancel プロパティを true に設定して現在のアクションをキャンセルする場合、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;
  }
}

.NET Framework のセキュリティ

• AspNetHostingPermission  (ホスト環境で ValidatePasswordEventArgs クラスを使用するために必要なアクセス許可)要求値 : LinkDemand。アクセス許可値 : Minimal。

継承階層

System.Object
   System.EventArgs
    System.Web.Security.ValidatePasswordEventArgs

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

参照

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