ValidatePasswordEventArgs.Cancel Propiedad

Definición

Espacio de nombres:

System.Web.Security

Ensamblado:

System.Web.ApplicationServices.dll

Obtiene o establece un valor que indica si se cancelará la acción de creación de usuario, cambio de contraseña o restablecimiento de contraseña actual del usuario.

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

Valor de propiedad

Boolean

true si se cancelará la acción actual de creación de usuario, cambio de contraseña o restablecimiento de contraseña; de lo contrario, false. De manera predeterminada, es false.

Ejemplos

En el ejemplo de código siguiente se muestra un ValidatingPassword evento que valida el formato de la contraseña para el usuario y cancela la acción si la contraseña no coincide con el formato necesario.

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

Comentarios

La Cancel propiedad se usa para cancelar la acción actual CreateUser, ChangePasswordo ResetPassword . Puede cancelar la acción actual estableciendo la Cancel propiedad true en durante el ValidatingPassword evento.

Si cancela la acción actual estableciendo la Cancel propiedad trueen , puede establecer la FailureInformation propiedad en una excepción que describa el motivo del error de validación de contraseña. El método que realiza la llamada producirá la excepción en la que se establece la FailureInformation propiedad . Si la FailureInformation propiedad es null, el autor de la llamada producirá una excepción genérica de error de validación de contraseña.

Consulte también

• Introducción a la pertenencia a ASP.NET