ValidatePasswordEventArgs.FailureInformation プロパティ

定義

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

public:
 property Exception ^ FailureInformation { Exception ^ get(); void set(Exception ^ value); };
public Exception FailureInformation { get; set; }
member this.FailureInformation : Exception with get, set
Public Property FailureInformation As Exception

プロパティ値

パスワード検証エラーの理由を説明する Exception

次のコード例は、 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

注釈

プロパティはFailureInformation、 プロパティを に設定することで、現在CreateUserの 、ChangePassword、または ResetPassword アクションが取り消された場合にCanceltrue使用されます。

プロパティは FailureInformation 、パスワード検証エラーの理由を説明する例外に設定されます。 呼び出し元のメソッドは、 プロパティが設定されている例外を FailureInformation スローします。 プロパティが の FailureInformation 場合、 null呼び出し元は一般的なパスワード検証エラー例外をスローします。

適用対象

こちらもご覧ください