TextBox.PasswordChar プロパティ

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

単一行 TextBox コントロールでパスワードの文字をマスクするために使用される文字を取得または設定します。

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

プロパティ値

Char

単一行 TextBox コントロールに入力された文字をマスクするために使用される文字。 入力時にコントロールで文字をマスクしない場合は、このプロパティの値を '0' (U+0000) に設定します。 既定値は '0' (U+0000) です。

例

次のコード例では、パスワードを TextBox 受け入れるために使用されるコントロールを作成します。 この例では、 プロパティを CharacterCasing 使用して、入力されたすべての文字を小文字に変更し、 プロパティを MaxLength 使用してパスワードの長さを 8 文字に制限します。 この例では、 プロパティを TextAlign 使用して、コントロールのパスワードを中央に配置 TextBox します。

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 優先されます。 が UseSystemPasswordChar に true設定されるたびに、既定のシステム パスワード文字が使用され、 によって PasswordChar 設定された文字はすべて無視されます。

プロパティが PasswordChar 設定されている場合、キーボードを使用してコントロール内の切り取りとコピーの操作を実行できません。

重要

TextBox、、または ReadOnly が のためPasswordCharUseSystemPasswordChar、 がパスワード モードの場合、 TextBox はtrue制限モードです。 このモードでは、 ImeMode は無効になっていますが、現在の が無制限になった場合に復元できるように、現在 ImeMode の が TextBox キャッシュされます。 を切り替えるの ReadOnly が一般的なシナリオです。 ImeModeコントロールが制限モードの間、 はシャドウされます。 デザイナーの観点からは、表示される ImeMode 値は実際の値です。