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 свойство , чтобы ограничить длину пароля восемью символами. В этом примере также используется 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 пароля, так как PasswordChar, UseSystemPasswordCharили ReadOnly имеет значение true, находится в режиме ограниченного TextBox доступа. В этом режиме ImeMode объект отключается, но текущий ImeMode кэшируется, чтобы его можно было восстановить, если TextBox когда-либо становится неограниченным. Переключение ReadOnly является распространенным сценарием. Элемент ImeMode управления затеняется, когда элемент управления находится в ограниченном режиме. С точки зрения конструктора отображаемое ImeMode значение является фактическим значением.