TextBox.PasswordChar プロパティ

定義

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

public char PasswordChar { get; set; }

プロパティ値

単一行 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 = 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;
 }

注釈

プロパティは UseSystemPasswordChar 、 プロパティよりも PasswordChar 優先されます。 が UseSystemPasswordChartrue設定されるたびに、既定のシステム パスワード文字が使用され、 によって PasswordChar 設定された文字はすべて無視されます。

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

重要

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

適用対象

製品 バージョン
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9