ValidatePasswordEventArgs 類別

定義

提供 MembershipProvider 類別的 ValidatingPassword 事件之事件資料。

public ref class ValidatePasswordEventArgs sealed : EventArgs
public sealed class ValidatePasswordEventArgs : EventArgs
type ValidatePasswordEventArgs = class
    inherit EventArgs
Public NotInheritable Class ValidatePasswordEventArgs
Inherits 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呼叫成員資格提供者的 CreateUserChangePasswordResetPassword 方法時,就會引發 事件。

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

您可以在事件期間 ValidatingPassword 將 屬性 true 設定 Cancel 為 ,以取消目前的 CreateUserChangePasswordResetPassword 動作。

如果您藉由將 屬性 true 設定 Cancel 為 來取消目前的動作,您可以將 屬性設定 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)

適用於

另請參閱