TextBox.PasswordChar プロパティ

定義

単一行 TextBox コントロールでパスワードの文字をマスクするために使用される文字を取得または設定します。Gets or sets the character used to mask characters of a password in a single-line TextBox control.

public:
 property char PasswordChar { char get(); void set(char value); };
public char PasswordChar { get; set; }
member this.PasswordChar : char with get, set
Public Property PasswordChar As Char

プロパティ値

単一行 TextBox コントロールに入力された文字をマスクするために使用される文字。The character used to mask characters entered in a single-line TextBox control. コントロールが入力時に文字をマスクしないようにする場合は、このプロパティの値を ' 0 ' (U + 0000) に設定します。Set the value of this property to '0' (U+0000) if you do not want the control to mask characters as they are typed. 既定値は ' 0 ' (U + 0000) です。The default value is '0' (U+0000).

次のコード例では、パスワードを受け入れるために使用される TextBox コントロールを作成します。The following code example creates a TextBox control that is used to accept a password. この例では、CharacterCasing プロパティを使用して、入力されたすべての文字を小文字に変更し、MaxLength プロパティを使用して、パスワードの長さを8文字に制限します。This example uses the CharacterCasing property to change all characters typed to lowercase and the MaxLength property to restrict the password length to eight characters. また、この例では、TextAlign プロパティを使用して、TextBox コントロールのパスワードを中央に配置します。This example also uses the TextAlign property to center the password in the TextBox control.

public:
   void CreateMyPasswordTextBox()
   {
      // Create an instance of the TextBox control.
      TextBox^ textBox1 = gcnew TextBox;
      // Set the maximum length of text in the control to eight.
      textBox1->MaxLength = 8;
      // Assign the asterisk to be the password character.
      textBox1->PasswordChar = '*';
      // Change all text entered to be lowercase.
      textBox1->CharacterCasing = CharacterCasing::Lower;
      // Align the text in the center of the TextBox control.
      textBox1->TextAlign = HorizontalAlignment::Center;
   }
public void CreateMyPasswordTextBox()
 {
    // Create an instance of the TextBox control.
    TextBox textBox1 = new TextBox();
    // Set the maximum length of text in the control to eight.
    textBox1.MaxLength = 8;
    // Assign the asterisk to be the password character.
    textBox1.PasswordChar = '*';
    // Change all text entered to be lowercase.
    textBox1.CharacterCasing = CharacterCasing.Lower;
    // Align the text in the center of the TextBox control.
    textBox1.TextAlign = HorizontalAlignment.Center;
 }
 
Public Sub CreateMyPasswordTextBox()
    ' Create an instance of the TextBox control.
    Dim textBox1 As New TextBox()
    ' Set the maximum length of text in the control to eight.
    textBox1.MaxLength = 8
    ' Assign the asterisk to be the password character.
    textBox1.PasswordChar = "*"c
    ' Change all text entered to be lowercase.
    textBox1.CharacterCasing = CharacterCasing.Lower
    ' Align the text in the center of the TextBox control.
    textBox1.TextAlign = HorizontalAlignment.Center
End Sub

注釈

UseSystemPasswordChar プロパティは、PasswordChar プロパティよりも優先されます。The UseSystemPasswordChar property has precedence over the PasswordChar property. UseSystemPasswordChartrueに設定されている場合、既定のシステムパスワード文字が使用され、PasswordChar によって設定された文字はすべて無視されます。Whenever the UseSystemPasswordChar is set to true, the default system password character is used and any character set by PasswordChar is ignored.

PasswordChar プロパティが設定されている場合、キーボードを使用してコントロールの切り取り操作とコピー操作を実行することはできません。When the PasswordChar property is set, cut and copy actions in the control using the keyboard cannot be performed.

重要

PasswordCharUseSystemPasswordChar、または ReadOnlytrueのために TextBox がパスワードモードになっている場合、TextBox は制限モードになります。When the TextBox is in password mode because PasswordChar, UseSystemPasswordChar, or ReadOnly is true, the TextBox is in restricted mode. このモードでは、ImeMode は無効になっていますが、現在の ImeMode はキャッシュされています。これにより、TextBox が無制限になった場合に復元できます。In this mode, the ImeMode is disabled, but the current ImeMode is cached so that it can be restored if the TextBox ever becomes unrestricted. ReadOnly の切り替えは一般的なシナリオです。Toggling the ReadOnly is a common scenario. コントロールが制限モードのときは、ImeMode がシャドウされます。The ImeMode is shadowed while the control is in restricted mode. デザイナーの観点から見ると、表示される ImeMode 値は実際の値です。From the designer perspective, the ImeMode value shown is the actual value.

適用対象