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

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 TextBox un contrôle qui est 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 CharacterCasing propriété pour remplacer tous les caractères tapés par des MaxLength minuscules et la propriété 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 TextAlign propriété pour centrer le mot de TextBox passe dans le contrôle.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 UseSystemPasswordChar propriété a priorité sur la PasswordChar propriété.The UseSystemPasswordChar property has precedence over the PasswordChar property. Chaque fois UseSystemPasswordChar que a la truevaleur, le caractère de mot de passe système par défaut est utilisé PasswordChar et tous les caractères définis par 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 PasswordChar propriété 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 de mot de UseSystemPasswordCharpasse, ReadOnly car true PasswordChar, ou TextBox est, le 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 actuel ImeMode est mis en cache afin qu’il puisse être restauré si TextBox le n’est jamais restreint.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 ReadOnly du est un scénario courant.Toggling the ReadOnly is a common scenario. Le ImeMode est occulté alors que le contrôle est en mode restreint.The ImeMode is shadowed while the control is in restricted mode. Du point de vue du concepteur ImeMode , la valeur affichée est la valeur réelle.From the designer perspective, the ImeMode value shown is the actual value.

S’applique à