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

注釈

プロパティは、 PasswordCharプロパティよりも優先されます。 UseSystemPasswordCharThe UseSystemPasswordChar property has precedence over the PasswordChar property. がにtrue設定されている場合、既定のシステムパスワード文字が使用されPasswordChar 、によって設定された文字はすべて無視されます。 UseSystemPasswordCharWhenever 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.

重要

UseSystemPasswordChar TextBox PasswordChar 、、ReadOnlyまたはがtrueの場合、がパスワードモードになっていると、は制限モードになります。 TextBoxWhen the TextBox is in password mode because PasswordChar, UseSystemPasswordChar, or ReadOnly is true, the TextBox is in restricted mode. このモードImeModeでは、は無効になっていますが、現在のが無制限になったTextBox場合に復元できるように、現在ImeModeのがキャッシュされています。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.

適用対象