TextBox.PasswordChar Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

TextBox.cs

Získá nebo nastaví znak použitý k maskování znaků hesla v jednořádkovém TextBox ovládacím prvku.

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

Hodnota vlastnosti

Char

Znak použitý k maskování znaků zadaných v ovládacím prvku s jedním řádkem TextBox . Pokud nechcete, aby ovládací prvek maskoval znaky při psaní, nastavte hodnotu 0 (U+0000). Výchozí hodnota je 0 (U+0000).

Příklady

Následující příklad kódu vytvoří TextBox ovládací prvek, který slouží k přijetí hesla. Tento příklad používá CharacterCasing vlastnost ke změně všech znaků zadaných malými písmeny a MaxLength vlastnost omezit délku hesla na osm znaků. Tento příklad také používá TextAlign vlastnost k zarovnání hesla do TextBox ovládacího prvku.

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

Poznámky

Vlastnost UseSystemPasswordChar má přednost před PasswordChar vlastností. Pokaždé, když je nastavená UseSystemPasswordChartruehodnota , použije se výchozí znak hesla systému a všechny znakové sady PasswordChar se ignorují.

PasswordChar Pokud je vlastnost nastavena, operace vyjmutí a kopírování v ovládacím prvku pomocí klávesnice nelze provést.

Důležité

Pokud je režim TextBox hesla, protože UseSystemPasswordCharPasswordChar, nebo ReadOnly je true, je , je v TextBox omezeném režimu. V tomto režimu je tato možnost ImeMode zakázaná, ale aktuální ImeMode je uložena v mezipaměti, aby bylo možné ji obnovit, pokud TextBox se někdy stane neomezeným. Přepínání ReadOnly je běžným scénářem. Stín ImeMode je stínován, když je ovládací prvek v omezeném režimu. Z pohledu návrháře je zobrazená ImeMode hodnota skutečná hodnota.