ValidatePasswordEventArgs.Cancel Properti

Definisi

Ruang nama:

System.Web.Security

Rakitan:

System.Web.ApplicationServices.dll

Mendapatkan atau menetapkan nilai yang menunjukkan apakah tindakan create-user, change-password, atau reset-password saat ini akan dibatalkan.

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

Nilai Properti

Boolean

true jika tindakan create-user, change-password, atau reset-password saat ini akan dibatalkan; jika tidak, false. Default adalah false.

Contoh

Contoh kode berikut menunjukkan ValidatingPassword peristiwa yang memvalidasi format kata sandi untuk pengguna dan membatalkan tindakan jika kata sandi tidak cocok dengan format yang diperlukan.

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

Keterangan

Properti Cancel digunakan untuk membatalkan tindakan , , ChangePasswordatau ResetPassword saat iniCreateUser. Anda dapat membatalkan tindakan saat ini dengan mengatur Cancel properti ke true selama ValidatingPassword acara.

Jika Anda membatalkan tindakan saat ini dengan mengatur Cancel properti ke true, Anda dapat mengatur FailureInformation properti ke pengecualian yang menjelaskan alasan kegagalan validasi kata sandi. Metode pemanggilan akan memberikan pengecualian bahwa FailureInformation properti diatur ke. FailureInformation Jika properti adalah null, pemanggil akan melemparkan pengecualian kegagalan validasi kata sandi generik.

Lihat juga

• Pengantar Keanggotaan ASP.NET