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.

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. Définissez la valeur de cette propriété sur « 0 » (U+0000) si vous ne souhaitez pas que le contrôle masque les caractères lorsqu’ils sont tapés. La valeur par défaut est '0' (U+0000).

Exemples

L’exemple de code suivant crée un TextBox contrôle utilisé pour accepter un mot de passe. Cet exemple utilise la CharacterCasing propriété pour modifier tous les caractères tapés en minuscules et la MaxLength propriété pour limiter la longueur du mot de passe à huit caractères. Cet exemple utilise également la TextAlign propriété pour centrer le mot de passe dans le TextBox contrôle .

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é est prioritaire sur la PasswordChar propriété . Chaque fois que est UseSystemPasswordChar défini sur true, le caractère de mot de passe système par défaut est utilisé et tout caractère défini par PasswordChar est ignoré.

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.

Important

Lorsque est TextBox en mode mot de passe, car PasswordChar, UseSystemPasswordCharou ReadOnly est true, est TextBox en mode restreint. Dans ce mode, le ImeMode est désactivé, mais le actuel ImeMode est mis en cache afin qu’il puisse être restauré si jamais devient TextBox illimité. Le basculement de est ReadOnly un scénario courant. est ImeMode ombré alors que le contrôle est en mode restreint. Du point de vue du concepteur, la ImeMode valeur affichée est la valeur réelle.

S’applique à