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

Definición

Obtiene o establece el carácter utilizado para enmascarar caracteres de una contraseña en una sola línea TextBox control.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

Valor de propiedad

El carácter utilizado para enmascarar caracteres escritos en una sola línea TextBox control.The character used to mask characters entered in a single-line TextBox control. Establezca el valor de esta propiedad en 0 (valor de carácter) si no desea que el control enmascare caracteres cuando se escriben.Set the value of this property to 0 (character value) if you do not want the control to mask characters as they are typed. De forma predeterminada, es igual a 0 (valor de carácter).Equals 0 (character value) by default.

Ejemplos

En el ejemplo de código siguiente se crea un TextBox control que se usa para aceptar una contraseña.The following code example creates a TextBox control that is used to accept a password. Este ejemplo se usa el CharacterCasing escrito propiedad quiere cambiar todos los caracteres en minúsculas y la MaxLength propiedad para restringir la longitud de contraseña a ocho caracteres.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. En este ejemplo también usa el TextAlign propiedad para centrar la contraseña en el TextBox control.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

Comentarios

El UseSystemPasswordChar propiedad tiene prioridad sobre la PasswordChar propiedad.The UseSystemPasswordChar property has precedence over the PasswordChar property. Cada vez que el UseSystemPasswordChar está establecido en true, se usa el carácter de contraseña predeterminado del sistema y cualquier carácter establecido por PasswordChar se omite.Whenever the UseSystemPasswordChar is set to true, the default system password character is used and any character set by PasswordChar is ignored.

Cuando el PasswordChar propiedad está establecida, no se puede realizar las acciones de cortar y copiar en el control mediante el teclado.When the PasswordChar property is set, cut and copy actions in the control using the keyboard cannot be performed.

Importante

Cuando el TextBox está en modo de contraseña porque PasswordChar, UseSystemPasswordChar, o ReadOnly es true, el TextBox está en modo restringido.When the TextBox is in password mode because PasswordChar, UseSystemPasswordChar, or ReadOnly is true, the TextBox is in restricted mode. En este modo, el ImeMode está deshabilitado, pero actual ImeMode se almacena en caché para que se pueda restaurar si el TextBox en algún momento sin restricciones.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. Si activa o desactiva el ReadOnly es un escenario común.Toggling the ReadOnly is a common scenario. El ImeMode se sombrea mientras el control está en modo restringido.The ImeMode is shadowed while the control is in restricted mode. Desde la perspectiva del diseñador, el ImeMode valor mostrado es el valor real.From the designer perspective, the ImeMode value shown is the actual value.

Se aplica a