TextBox.PasswordChar Propriété

Définition

Obtient ou définit le caractère servant à masquer les caractères d'un mot de passe dans un contrôle TextBox sur une ligne.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

Valeur de propriété

Caractère servant à masquer les caractères d'un mot de passe dans un contrôle TextBox sur une ligne.The character used to mask characters entered in a single-line TextBox control. Affectez à cette propriété la valeur « 0 » (U + 0000) si vous ne souhaitez pas que le contrôle masque les caractères au fur et à mesure qu’ils sont tapés.Set the value of this property to '0' (U+0000) if you do not want the control to mask characters as they are typed. La valeur par défaut est « 0 » (U + 0000).The default value is '0' (U+0000).

Exemples

L’exemple de code suivant crée un contrôle TextBox utilisé pour accepter un mot de passe.The following code example creates a TextBox control that is used to accept a password. Cet exemple utilise la propriété CharacterCasing pour remplacer tous les caractères tapés par des minuscules et la propriété MaxLength pour limiter la longueur du mot de passe à huit caractères.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. Cet exemple utilise également la propriété TextAlign pour centrer le mot de passe dans le contrôle 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

Remarques

La propriété UseSystemPasswordChar a priorité sur la propriété PasswordChar.The UseSystemPasswordChar property has precedence over the PasswordChar property. Chaque fois que le UseSystemPasswordChar est défini sur true, le caractère de mot de passe système par défaut est utilisé et tous les jeux de caractères par PasswordChar sont ignorés.Whenever the UseSystemPasswordChar is set to true, the default system password character is used and any character set by PasswordChar is ignored.

Lorsque la propriété PasswordChar est définie, les actions couper et copier dans le contrôle à l’aide du clavier ne peuvent pas être effectuées.When the PasswordChar property is set, cut and copy actions in the control using the keyboard cannot be performed.

Important

Lorsque le TextBox est en mode mot de passe parce que PasswordChar, UseSystemPasswordCharou ReadOnly est true, le TextBox est en mode restreint.When the TextBox is in password mode because PasswordChar, UseSystemPasswordChar, or ReadOnly is true, the TextBox is in restricted mode. Dans ce mode, le ImeMode est désactivé, mais le ImeMode actuel est mis en cache afin qu’il puisse être restauré si le TextBox devient sans restriction.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. Le basculement de l' ReadOnly est un scénario courant.Toggling the ReadOnly is a common scenario. Le ImeMode est occulté lorsque le contrôle est en mode restreint.The ImeMode is shadowed while the control is in restricted mode. Du point de vue du concepteur, la valeur de ImeMode affichée est la valeur réelle.From the designer perspective, the ImeMode value shown is the actual value.

S’applique à