TextBox.PasswordChar Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define o caractere usado para mascarar caracteres de uma senha em um controle TextBox de linha única.

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

Valor da propriedade

Char

O caractere usado para mascarar caracteres inseridos em um controle TextBox de linha única. Defina o valor dessa propriedade como '0' (U+0000) se você não quiser que o controle mascara caracteres conforme eles são digitados. O valor padrão é '0' (U+0000).

Exemplos

O exemplo de código a seguir cria um TextBox controle usado para aceitar uma senha. Este exemplo usa a CharacterCasing propriedade para alterar todos os caracteres digitado em minúsculas e a MaxLength propriedade para restringir o comprimento da senha a oito caracteres. Este exemplo também usa a TextAlign propriedade para centralizar a senha no TextBox controle .

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

Comentários

A UseSystemPasswordChar propriedade tem precedência sobre a PasswordChar propriedade . Sempre que o UseSystemPasswordChar é definido truecomo , o caractere de senha do sistema padrão é usado e qualquer conjunto de caracteres por PasswordChar é ignorado.

Quando a PasswordChar propriedade é definida, ações de recortar e copiar no controle usando o teclado não podem ser executadas.

Importante

Quando o TextBox está no modo de senha porque PasswordChar, UseSystemPasswordCharou ReadOnly é true, o TextBox está no modo restrito. Nesse modo, o ImeMode está desabilitado, mas o atual ImeMode é armazenado em cache para que possa ser restaurado se o TextBox se tornar irrestrito. Alternar o ReadOnly é um cenário comum. O ImeMode é sombreado enquanto o controle está no modo restrito. Da perspectiva do designer, o ImeMode valor mostrado é o valor real.