TextBox.PasswordChar Tulajdonság

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

TextBox.cs

Lekéri vagy beállítja a jelszó karaktereinek maszkolásához használt karaktert egy egysoros TextBox vezérlőben.

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

Tulajdonság értéke

Char

Az egysoros TextBox vezérlőelemben megadott karakterek maszkolásához használt karakter. Állítsa a tulajdonság értékét "0" (U+0000) értékre, ha nem szeretné, hogy a vezérlőelem a beíráskor maszkolja a karaktereket. Az alapértelmezett érték a "0" (U+0000).

Példák

Az alábbi példakód egy TextBox jelszót elfogadó vezérlőt hoz létre. Ez a példa a tulajdonság használatával módosítja a CharacterCasing kisbetűsre beírt karaktereket, a MaxLength tulajdonság pedig nyolc karakterre korlátozza a jelszó hosszát. Ez a példa a TextAlign tulajdonság használatával is középre helyezi a jelszót a TextBox vezérlőben.

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

Megjegyzések

A UseSystemPasswordChar tulajdonság elsőbbséget élvez a PasswordChar tulajdonságnál. Amikor az UseSystemPasswordChar érték be van állítva true, a rendszer az alapértelmezett rendszerjelszót használja, és az általa PasswordChar beállított karaktereket figyelmen kívül hagyja.

Ha a PasswordChar tulajdonság be van állítva, a billentyűzettel végzett kivágási és másolási műveletek nem hajthatóak végre a vezérlőben.

Important

Ha a TextBox jelszó módban van, PasswordCharUseSystemPasswordCharReadOnlytrue mert TextBoxaz korlátozott módban van. Ebben a módban a ImeMode rendszer le van tiltva, de az áram ImeMode gyorsítótárazva van, így visszaállítható, ha a TextBox rendszer korlátlanná válik. Az összesítés ReadOnly gyakori forgatókönyv. A ImeMode vezérlő árnyékolt, míg a vezérlő korlátozott módban van. Tervezői szempontból a ImeMode megjelenített érték a tényleges érték.