ValidatePasswordEventArgs.FailureInformation プロパティとは何？わかりやすく解説 Weblio辞書

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

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

ValidatePasswordEventArgs.FailureInformation プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

パスワード検証エラーの理由を説明する例外を取得または設定します。

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

Visual Basic (宣言)

Public Property FailureInformation As
 Exception

Visual Basic (使用法)

Dim instance As ValidatePasswordEventArgs
Dim value As Exception

value = instance.FailureInformation

instance.FailureInformation = value

public Exception FailureInformation { get;
 set; }

C++

public:
property Exception^ FailureInformation {
    Exception^ get ();
    void set (Exception^ value);
}

/** @property */
public Exception get_FailureInformation ()

/** @property */
public void set_FailureInformation (Exception
 value)

JScript

public function get FailureInformation
 () : Exception

public function set FailureInformation
 (value : Exception)

プロパティ値
パスワード検証エラーの理由を説明する Exception。

解説

FailureInformation プロパティは、現在の 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

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