ValidatePasswordEventArgs.Cancel Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.Security
Bütünleştirilmiş Kod:
System.Web.dll
Bütünleştirilmiş Kod:
System.Web.ApplicationServices.dll

Geçerli create-user, change-password veya reset-password eyleminin iptal edilip edilmeyeceğini belirten bir değer alır veya ayarlar.

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

Özellik Değeri

Boolean

true geçerli create-user, change-password veya reset-password eylemi iptal edilirse; aksi takdirde , false. Varsayılan değer: false.

Örnekler

Aşağıdaki kod örneği, kullanıcı için parolanın biçimini doğrulayan ve parola gerekli biçimle eşleşmiyorsa eylemi iptal eden bir ValidatingPassword olayı gösterir.

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

Açıklamalar

Cancel özelliği geçerli CreateUser, ChangePasswordveya ResetPassword eylemini iptal etmek için kullanılır. Olay sırasında ValidatingPassword özelliğini true olarak ayarlayarak Cancel geçerli eylemi iptal edebilirsiniz.

Özelliğini olarak ayarlayarak Cancel geçerli eylemi iptal ederseniz, özelliği parola doğrulama hatasının nedenini açıklayan bir özel durum olarak ayarlayabilirsinizFailureInformation.true Çağıran yöntem özelliğin ayarlandığı FailureInformation özel durumu oluşturur. FailureInformation özelliği isenull, çağıran genel bir parola doğrulama hatası özel durumu oluşturur.

Şunlara uygulanır

Ayrıca bkz.