TextBox.PasswordChar TextBox.PasswordChar TextBox.PasswordChar TextBox.PasswordChar Property

Определение

Получает или задает символ, используемый для маскировки знаков пароля в однострочный 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 (символьное значение), если вы не хотите элемент управления для маскировки знаков при вводе.Set the value of this property to 0 (character value) if you do not want the control to mask characters as they are typed. По умолчанию, равно 0 (символьное значение).Equals 0 (character value) by default.

Примеры

В следующем примере кода создается 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

Комментарии

UseSystemPasswordChar Свойство имеет приоритет над PasswordChar свойство.The 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.

Важно!

Когда TextBox находится в режиме пароль, так как PasswordChar, UseSystemPasswordChar, или ReadOnlytrue, TextBox находится в ограниченном режиме.When 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.

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