TextBox.PasswordChar Propiedad

Definición

Obtiene o establece los caracteres utilizados para enmascarar caracteres de una contraseña en un control TextBox de una sola línea.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

Carácter utilizado para enmascarar caracteres escritos en un control TextBox de una sola línea.The character used to mask characters entered in a single-line TextBox control. Establezca el valor de esta propiedad en ' 0 ' (U + 0000) si no desea que el control enmascare caracteres a medida que se escriben.Set the value of this property to '0' (U+0000) if you do not want the control to mask characters as they are typed. El valor predeterminado es "0" (U + 0000).The default value is '0' (U+0000).

Ejemplos

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

La UseSystemPasswordChar propiedad tiene prioridad sobre la PasswordChar propiedad.The UseSystemPasswordChar property has precedence over the PasswordChar property. Siempre que truese establece en, se usa el carácter de contraseña predeterminado del sistema y se omite cualquier juego de caracteres de PasswordChar. UseSystemPasswordCharWhenever the UseSystemPasswordChar is set to true, the default system password character is used and any character set by PasswordChar is ignored.

Cuando se PasswordChar establece la propiedad, no se pueden realizar las acciones de cortar y copiar en el control con 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 PasswordCharporque 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 ImeMode el objeto actual se almacena en caché para que se pueda TextBox restaurar si el objeto se vuelve 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. Alternar ReadOnly es un escenario común.Toggling the ReadOnly is a common scenario. 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, ImeMode el valor mostrado es el valor real.From the designer perspective, the ImeMode value shown is the actual value.

Se aplica a