ValidatePasswordEventArgs クラス

リファレンス

定義

名前空間:: System.Web.Security

アセンブリ:: System.Web.dll

アセンブリ:: System.Web.ApplicationServices.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

public ref class ValidatePasswordEventArgs sealed : EventArgs

public sealed class ValidatePasswordEventArgs : EventArgs

type ValidatePasswordEventArgs = class
    inherit EventArgs

Public NotInheritable Class ValidatePasswordEventArgs
Inherits EventArgs

継承: Object

EventArgs
ValidatePasswordEventArgs

例

次のコード例は、 ValidatingPassword ユーザーのパスワードの形式を検証し、パスワードが必要な形式と一致しない場合にアクションを取り消すイベントを示しています。

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 メソッドが呼び出されたときに発生します。

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

イベント中にプロパティをに設定することで、現在CreateUserの Cancel 、ChangePassword、または ResetPassword アクションをValidatingPassword取り消すことができます。true

プロパティをにtrue設定して現在のアクションをCancelキャンセルする場合は、パスワード検証エラーのFailureInformation理由を説明する例外にプロパティを設定できます。呼び出し元のメソッドは、プロパティが設定されている例外を FailureInformation スローします。プロパティが FailureInformation の場合、 null呼び出し元は一般的なパスワード検証エラー例外をスローします。

コンストラクター

ValidatePasswordEventArgs(String, String, Boolean)

ValidatePasswordEventArgs クラスの新しいインスタンスを作成します。

プロパティ

Cancel	現在のユーザーの作成、パスワードの変更、またはパスワードのリセットの操作が取り消されるかどうかを示す値を取得または設定します。
FailureInformation	パスワード検証エラーの理由を説明する例外を取得または設定します。
IsNewUser	ValidatingPassword イベントが CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) メソッドの呼び出し中に発生しているかどうかを示す値を取得します。
Password	現在のユーザーの作成、パスワードの変更、またはパスワードのリセット操作のためのパスワードを取得します。
UserName	現在のユーザーの作成、パスワードの変更、またはパスワードのリセット操作のメンバーシップユーザーの名前を取得します。

メソッド

Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

適用対象

こちらもご覧ください

ASP.NET メンバーシップの概要

次の方法で共有