TextBox.PasswordChar Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Źródło:

TextBox.cs

Pobiera lub ustawia znak używany do maskowania znaków hasła w kontrolce jednowierszowej 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

Wartość właściwości

Char

Znak używany do maskowania znaków wprowadzonych w kontrolce jednowierszowej TextBox . Ustaw wartość tej właściwości na "0" (U+0000), jeśli nie chcesz, aby kontrolka maskować znaki podczas wpisywania. Wartość domyślna to "0" (U+0000).

Przykłady

Poniższy przykład kodu tworzy kontrolkę TextBox używaną do akceptowania hasła. W tym przykładzie użyto CharacterCasing właściwości , aby zmienić wszystkie znaki wpisane na małe litery i MaxLength właściwość, aby ograniczyć długość hasła do ośmiu znaków. W tym przykładzie TextAlign użyto również właściwości , aby wyśrodkować hasło w kontrolce 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

Uwagi

Właściwość UseSystemPasswordChar ma pierwszeństwo przed właściwością PasswordChar . Zawsze, UseSystemPasswordChar gdy ustawiono truewartość , jest używany domyślny znak hasła systemu, a dowolny znak ustawiony przez PasswordChar jest ignorowany.

Po ustawieniu PasswordChar właściwości nie można wykonać akcji wycinania i kopiowania w kontrolce za pomocą klawiatury.

Ważne

Gdy element TextBox jest w trybie hasła, ponieważ PasswordChar, UseSystemPasswordCharlub ReadOnly jest true, TextBox jest w trybie ograniczonym. W tym trybie jest wyłączony, ImeMode ale bieżący ImeMode jest buforowany, aby można było go przywrócić, jeśli TextBox kiedykolwiek stanie się nieograniczony. Przełączenie jest ReadOnly typowym scenariuszem. Kontrolka ImeMode jest w tle, gdy kontrolka jest w trybie ograniczonym. Z perspektywy projektanta wyświetlana ImeMode wartość jest rzeczywistą wartością.