ChangePassword.PasswordHintText プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ChangePassword.PasswordHintText プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

Web サイトのパスワードを作成するための要件に関する情報テキストを取得または設定します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public Overridable Property
 PasswordHintText As String

Visual Basic (使用法)

Dim instance As ChangePassword
Dim value As String

value = instance.PasswordHintText

instance.PasswordHintText = value

[LocalizableAttribute(true)] 
public virtual string PasswordHintText { get;
 set; }

C++

[LocalizableAttribute(true)] 
public:
virtual property String^ PasswordHintText {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_PasswordHintText ()

/** @property */
public void set_PasswordHintText (String value)

JScript

public function get PasswordHintText
 () : String

public function set PasswordHintText
 (value : String)

プロパティ値
新しいパスワードの基準について表示する情報テキスト。既定値は Empty です。

解説

PasswordHintText プロパティは、Web サイトのパスワードを作成するための要件に関する情報テキストを取得または設定します。このプロパティを使用して、NewPasswordRegularExpression プロパティで指定した新しいパスワードの要件を説明します。

このプロパティの値は、設定時に、デザイナツールを使用してリソースファイルに自動的に保存できます。詳細については、「LocalizableAttribute」、「ASP.NET のグローバリゼーションおよびローカリゼーション」の各トピックを参照してください。

使用例

NewPasswordRegularExpression プロパティを設定して、以下の基準に一致するようにパスワードをチェックする正規表現を定義する方法を次のコード例に示します。

6 文字より多いこと。
少なくとも 1 つの数字を含むこと。
少なくとも 1 つの特殊 (英数字以外) 文字を含むこと。

PasswordHintText プロパティに格納されたパスワード要件は、ユーザーに表示されます。

ユーザーの入力したパスワードが基準を満たしていない場合、NewPasswordRegularExpressionErrorMessage プロパティに格納されたテキストがユーザーに表示されます。新しいパスワードが入力されない場合、NewPasswordRequiredErrorMessage プロパティに格納されたテキストがユーザーに表示されます。

メモ
新しいパスワードは、MinRequiredPasswordLength、MinRequiredNonAlphanumericCharacters、および PasswordStrengthRegularExpression の各プロパティのメンバシッププロバイダによって設定される最低限の条件を満たす必要もあります。パスワードがこれらの要件を満たしていない場合、ChangePasswordError イベントが発生します。

メモ

新しいパスワードは、MinRequiredPasswordLength、MinRequiredNonAlphanumericCharacters、および PasswordStrengthRegularExpression の各プロパティのメンバシッププロバイダによって設定される最低限の条件を満たす必要もあります。パスワードがこれらの要件を満たしていない場合、ChangePasswordError イベントが発生します。

Visual Basic

<%@ page language="VB"%>

<script runat="server">

</script>

<html>
<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>

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

<script runat="server">

</script>

<html>
<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>