Freigeben über

ChangePassword.PasswordHintText Eigenschaft

Definition

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

Dient zum Abrufen oder Festlegen von Informationstext zu den Anforderungen zum Erstellen eines Kennworts für die Website.

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

Eigenschaftswert

String

Der Informationstext, der über die Kriterien für das neue Kennwort angezeigt werden soll. Der Standardwert lautet Empty.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die NewPasswordRegularExpression Eigenschaft so festlegen, dass ein regulärer Ausdruck definiert wird, der Kennwörter überprüft, um sicherzustellen, dass sie die folgenden Kriterien erfüllen:

  • Sind größer als sechs Zeichen.

  • Mindestens eine Ziffer enthalten.

  • Enthält mindestens ein spezielles (nicht alphanumerisches) Zeichen.

Die in der PasswordHintText Eigenschaft enthaltenen Kennwortanforderungen werden dem Benutzer angezeigt.

Wenn das vom Benutzer eingegebene Kennwort nicht den Kriterien entspricht, wird der in der NewPasswordRegularExpressionErrorMessage Eigenschaft enthaltene Text dem Benutzer angezeigt. Wenn kein neues Kennwort eingegeben wird, wird der text, der in der NewPasswordRequiredErrorMessage Eigenschaft enthalten ist, dem Benutzer angezeigt.

Hinweis

Das neue Kennwort muss auch die Mindestanforderungen erfüllen, die vom Mitgliedschaftsanbieter in den MinRequiredPasswordLength, MinRequiredNonAlphanumericCharactersund PasswordStrengthRegularExpression Eigenschaften festgelegt werden. Wenn das Kennwort diese Anforderungen nicht erfüllt, wird das ChangePasswordError Ereignis ausgelöst.

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

Hinweise

Die PasswordHintText Eigenschaft ruft Informationen zu den Anforderungen zum Erstellen eines Kennworts für die Website ab oder legt sie fest. Verwenden Sie diese Eigenschaft, um die Anforderungen für das neue Kennwort zu beschreiben, das in der NewPasswordRegularExpression Eigenschaft angegeben ist.

Der Wert dieser Eigenschaft kann automatisch mithilfe eines Designertools in einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute"Globalisierung und Lokalisierung".

Gilt für:

Weitere Informationen