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呼叫成員資格提供者的、 ChangePassword或 ResetPassword 方法時CreateUser，就會引發 事件。

您可以處理 ValidatingPassword 事件，以驗證成員資格使用者的密碼格式和值。

您可以在事件期間ValidatingPassword將 Cancel 屬性設定為 true ，以取消目前的CreateUser、 ChangePassword或 ResetPassword 動作。

如果您藉由將 屬性設定 Cancel 為 true來取消目前的動作，您可以將 屬性設定 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 成員資格簡介