ChangePassword.PasswordHintText Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece el texto informativo sobre los requisitos necesarios para crear una contraseña para el sitio Web.

public:
 virtual property System::String ^ PasswordHintText { System::String ^ get(); void set(System::String ^ value); };
public virtual string PasswordHintText { get; set; }
member this.PasswordHintText : string with get, set
Public Overridable Property PasswordHintText As String

Valor de propiedad

String

Texto informativo que se va mostrar sobre los criterios de la nueva contraseña. De manera predeterminada, es Empty.

Ejemplos

En el ejemplo de código siguiente se muestra cómo establecer la NewPasswordRegularExpression propiedad para definir una expresión regular que comprueba las contraseñas para asegurarse de que cumplen los criterios siguientes:

  • Son mayores de seis caracteres.

  • Contener al menos un dígito.

  • Contener al menos un carácter especial (no alfanumérico).

Los requisitos de contraseña contenidos en la PasswordHintText propiedad se muestran al usuario.

Si la contraseña escrita por el usuario no cumple los criterios, el texto contenido en la NewPasswordRegularExpressionErrorMessage propiedad se muestra al usuario. Si no se escribe una nueva contraseña, el texto contenido en la NewPasswordRequiredErrorMessage propiedad se muestra al usuario.

Nota

La nueva contraseña también debe cumplir los requisitos mínimos establecidos por el proveedor de pertenencia en las MinRequiredPasswordLengthpropiedades , MinRequiredNonAlphanumericCharactersy PasswordStrengthRegularExpression . Si la contraseña no cumple estos requisitos, se genera el ChangePasswordError evento .

<%@ page language="C#"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>Change Password with Validation</title>
</head>
<body>
  <form id="form1" runat="server">
  <div>
  <asp:changepassword id="ChangePassword1" runat="server"
  PasswordHintText = 
    "Please enter a password at least 7 characters long, 
    containing a number and one special character."
  NewPasswordRegularExpression =
    '@\"(?=.{7,})(?=(.*\d){1,})(?=(.*\W){1,})' 
  NewPasswordRegularExpressionErrorMessage =
    "Error: Your password must be at least 7 characters long, 
    and contain at least one number and one special character." >
  </asp:changepassword>
  </div>
  </form>
</body>
</html>

<%@ page language="VB"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>Change Password with Validation</title>
</head>
<body>
  <form id="form1" runat="server">
  <div>
  <asp:changepassword id="ChangePassword1" runat="server"
  PasswordHintText = "Please enter a password at least 7 characters long, containing a number and one special character."
  NewPasswordRegularExpression = '@\"(?=.{7,})(?=(.*\d){1,})(?=(.*\W){1,})' 
  NewPasswordRegularExpressionErrorMessage = "Your password must be at least 7 characters long, and contain at least one number and one special character.">
  </asp:changepassword>
  </div>
  </form>
</body>
</html>

Comentarios

La PasswordHintText propiedad obtiene o establece texto informativo sobre los requisitos para crear una contraseña para el sitio web. Utilice esta propiedad para describir los requisitos de la nueva contraseña especificada en la NewPasswordRegularExpression propiedad .

El valor de esta propiedad, cuando se establece, se puede guardar automáticamente en un archivo de recursos mediante una herramienta de diseñador. Para obtener más información, vea LocalizableAttributeGlobalización y localización.

Se aplica a

Consulte también