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 操作。 可以通过在事件期间ValidatingPassword将 Cancel 属性设置为 true 来取消当前操作。

如果通过将 属性设置为 Canceltrue来取消当前操作，则可以将 FailureInformation 属性设置为描述密码验证失败原因的异常。 调用方法将引发 属性设置为 的 FailureInformation 异常。 FailureInformation如果 属性为 null，则调用方将引发泛型密码验证失败异常。

另请参阅

• ASP.NET 成员资格简介