ValidatePasswordEventArgs 类

定义

命名空间:

System.Web.Security

程序集:

System.Web.ApplicationServices.dll

为 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 验证成员身份用户的密码格式和值。

可以通过在 事件期间将 属性设置为 true 来取消当前的 CreateUser、 ChangePassword或 ResetPassword 操作。CancelValidatingPassword

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

构造函数

ValidatePasswordEventArgs(String, String, Boolean)

创建 ValidatePasswordEventArgs 类的新实例。

属性

Cancel	获取或设置一个值，该值指示是否将取消当前的创建用户、更改密码或重置密码操作。
FailureInformation	获取或设置描述密码验证失败的原因的异常。
IsNewUser	获取一个值，该值指示调用 CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) 方法的过程中是否引发 ValidatingPassword 事件。
Password	获取当前创建用户、密码更改或重置密码操作的密码。
UserName	获取当前创建用户、更改密码或重置密码操作的成员资格用户名。

方法

Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

另请参阅

• ASP.NET 成员资格简介