TextBox.PasswordChar Свойство

Определение

Получает или задает знак, используемый для маскировки знаков пароля, вводимых в однострочный элемент управления TextBox.Gets or sets the character used to mask characters of a password in a single-line TextBox control.

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

Значение свойства

Знак, используемый для маскировки ввода знаков в однострочный элемент управления TextBox.The character used to mask characters entered in a single-line TextBox control. Установите значение этого свойства равным "0" (U + 0000), если не нужно, чтобы элемент управления маскирует символы по мере их ввода.Set the value of this property to '0' (U+0000) if you do not want the control to mask characters as they are typed. Значение по умолчанию — 0 (U + 0000).The default value is '0' (U+0000).

Примеры

В следующем примере кода создается TextBox элемент управления, используемый для принятия пароля.The following code example creates a TextBox control that is used to accept a password. В этом примере CharacterCasing свойство используется для изменения всех символов, введенных в нижний MaxLength регистр, а свойство — для ограничения длины пароля до восьми символов.This example uses the CharacterCasing property to change all characters typed to lowercase and the MaxLength property to restrict the password length to eight characters. В этом примере также используется TextAlign свойство для центрирования пароля TextBox в элементе управления.This example also uses the TextAlign property to center the password in the TextBox control.

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

Комментарии

Свойство имеет приоритет PasswordChar над свойством. UseSystemPasswordCharThe UseSystemPasswordChar property has precedence over the PasswordChar property. Если параметру UseSystemPasswordChar trueприсвоено значение, используется символ системного пароля по умолчанию, PasswordChar а любой набор символов игнорируется.Whenever the UseSystemPasswordChar is set to true, the default system password character is used and any character set by PasswordChar is ignored.

PasswordChar Если свойство задано, операции вырезания и копирования в элементе управления с помощью клавиатуры не могут быть выполнены.When the PasswordChar property is set, cut and copy actions in the control using the keyboard cannot be performed.

Важно!

true UseSystemPasswordChar PasswordChar ReadOnly Если находится в режиме пароля, так как, или имеет значение, TextBox находится в ограниченном режиме. TextBoxWhen the TextBox is in password mode because PasswordChar, UseSystemPasswordChar, or ReadOnly is true, the TextBox is in restricted mode. В этом режиме параметр ImeMode отключен, но текущий ImeMode кэш кэшируется, чтобы его можно было восстановить, если все когда TextBox -либо преобразуются в неограниченные.In this mode, the ImeMode is disabled, but the current ImeMode is cached so that it can be restored if the TextBox ever becomes unrestricted. ReadOnly Переключение является распространенным сценарием.Toggling the ReadOnly is a common scenario. Объект ImeMode перебрасывается, пока элемент управления находится в режиме с ограниченным доступом.The ImeMode is shadowed while the control is in restricted mode. С точки зрения ImeMode конструктора отображаемое значение является фактическим значением.From the designer perspective, the ImeMode value shown is the actual value.

Применяется к