TextBox.PasswordChar Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece los caracteres utilizados para enmascarar caracteres de una contraseña en un control TextBox de una sola línea.

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 de propiedad

Char

Carácter utilizado para enmascarar caracteres escritos en un control TextBox de una sola línea. Establezca el valor de esta propiedad en "0" (U+0000) si no desea que el control enmascara los caracteres a medida que se escriben. El valor predeterminado es '0' (U+0000).

Ejemplos

En el ejemplo de código siguiente se crea un TextBox control que se usa para aceptar una contraseña. En este ejemplo se usa la CharacterCasing propiedad para cambiar todos los caracteres tipados a minúsculas y la MaxLength propiedad para restringir la longitud de la contraseña a ocho caracteres. En este ejemplo también se usa la TextAlign propiedad para centrar la contraseña en el 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

Comentarios

La UseSystemPasswordChar propiedad tiene prioridad sobre la PasswordChar propiedad . Cada vez que se establece trueen UseSystemPasswordChar , se usa el carácter de contraseña del sistema predeterminado y se omite cualquier juego de caracteres porPasswordChar.

Cuando se establece la PasswordChar propiedad, no se pueden realizar acciones de cortar y copiar en el control mediante el teclado.

Importante

TextBox Cuando está en modo de contraseña porque PasswordChar, UseSystemPasswordCharo ReadOnly es true, está TextBox en modo restringido. En este modo, ImeMode está deshabilitado, pero el actual ImeMode se almacena en caché para que se pueda restaurar si alguna TextBox vez se vuelve sin restricciones. Alternar es ReadOnly un escenario común. ImeMode está sombreado mientras el control está en modo restringido. Desde la perspectiva del diseñador, el ImeMode valor que se muestra es el valor real.