ValidatePasswordEventArgs.Cancel Eigenschap

Definitie

Naamruimte:
System.Web.Security
Assembly:
System.Web.dll
Assembly:
System.Web.ApplicationServices.dll

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de huidige actie create-user, change-password of reset-password wordt geannuleerd.

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

Waarde van eigenschap

Boolean

true als de huidige actie create-user, change-password of reset-password wordt geannuleerd; anders, false. De standaardwaarde is false.

Voorbeelden

In het volgende codevoorbeeld ziet u een ValidatingPassword gebeurtenis die de indeling van het wachtwoord voor de gebruiker valideert en de actie annuleert als het wachtwoord niet overeenkomt met de vereiste indeling.

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

Opmerkingen

De Cancel eigenschap wordt gebruikt om de huidige CreateUser, ChangePasswordof ResetPassword actie te annuleren. U kunt de huidige actie annuleren door de Cancel eigenschap in te true stellen op tijdens de ValidatingPassword gebeurtenis.

Als u de huidige actie annuleert door de Cancel eigenschap in te truestellen op , kunt u de FailureInformation eigenschap instellen op een uitzondering die de reden voor de mislukte wachtwoordvalidatie beschrijft. De aanroepmethode genereert de uitzondering waarop de FailureInformation eigenschap is ingesteld. Als de FailureInformation eigenschap is null, genereert de aanroeper een algemene uitzondering voor wachtwoordvalidatie.

Van toepassing op

Zie ook