ChangePassword.NewPasswordRegularExpression Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtém ou define a expressão regular usada para validar a senha fornecida pelo usuário.

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

Valor da propriedade

String

A cadeia de caracteres da expressão regular usada para validar a nova senha fornecida pelo usuário. O padrão é Empty.

Exemplos

O exemplo de código a seguir mostra como definir a NewPasswordRegularExpression propriedade para definir uma expressão regular que verifica senhas para garantir que elas atendam aos seguintes critérios:

  • São maiores que seis caracteres.

  • Contém pelo menos um dígito.

  • Contém pelo menos um caractere especial (não alfanumérico).

Os requisitos de senha contidos na PasswordHintText propriedade são exibidos para o usuário.

Se a senha inserida pelo usuário não atender aos critérios, o texto contido na NewPasswordRegularExpressionErrorMessage propriedade será exibido para o usuário. Se uma nova senha não for inserida, o texto contido na NewPasswordRequiredErrorMessage propriedade será exibido para o usuário.

Observação

A nova senha também deve atender aos requisitos mínimos definidos pelo provedor de associação nas MinRequiredPasswordLengthpropriedades , MinRequiredNonAlphanumericCharacterse PasswordStrengthRegularExpression . Se a senha não atender a esses requisitos, o ChangePasswordError evento será gerado.

<%@ 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>

Comentários

Use a NewPasswordRegularExpression propriedade para definir os requisitos de senhas usadas para validar contas de usuário em seu site. Essa expressão regular é usada para impor regras de senha no lado do cliente. O NewPasswordRegularExpression não está relacionado à imposição de senha que pode ser configurada no nível do armazenamento de dados. A senha deve atender aos requisitos mínimos definidos pelo provedor de associação nas MinRequiredPasswordLengthpropriedades , MinRequiredNonAlphanumericCharacterse PasswordStrengthRegularExpression . Se a senha não atender a esses requisitos, o ChangePasswordError evento será gerado.

Para exibir os requisitos para o usuário, defina a PasswordHintText propriedade .

Se a senha inserida não passar a expressão regular contida na NewPasswordRegularExpression propriedade , o texto contido na NewPasswordRegularExpressionErrorMessage propriedade será exibido para o usuário.

Se a senha for rejeitada pelo provedor de associação, o texto contido na ChangePasswordFailureText propriedade será exibido.

Um uso comum de padrões de senha é forçar os usuários a selecionar senhas fortes. Como prática recomendada, aplique regras de senha no nível de dados no provedor de associação. A NewPasswordRegularExpression propriedade permite a conveniência de verificar a senha no lado do cliente, mas não bloqueia os usuários que fazem repetidas tentativas de logon. Para melhorar a segurança, configure seu provedor de associação para restringir o número de tentativas que um usuário pode fazer para fazer logon. Para obter mais informações, consulte Protegendo a associação.

Aplica-se a

Confira também