ValidatePasswordEventArgs.Cancel プロパティ

定義

名前空間:

System.Web.Security

アセンブリ:

System.Web.ApplicationServices.dll

現在のユーザーの作成、パスワードの変更、またはパスワードのリセットの操作が取り消されるかどうかを示す値を取得または設定します。

public:
 property bool Cancel { bool get(); void set(bool value); };

public bool Cancel { get; set; }

member this.Cancel : bool with get, set

Public Property Cancel As Boolean

プロパティ値

Boolean

現在のユーザーの作成、パスワードの変更、またはパスワードのリセット操作が取り消される場合は、true。それ以外の場合は、false。 既定値は、false です。

例

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

注釈

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

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

こちらもご覧ください

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