TextBox.CharacterCasing Property

Definition

Obtient ou définit si le contrôle TextBox modifie la casse des caractères au fur et à mesure de la saisie.Gets or sets whether the TextBox control modifies the case of characters as they are typed.

public:
 property System::Windows::Forms::CharacterCasing CharacterCasing { System::Windows::Forms::CharacterCasing get(); void set(System::Windows::Forms::CharacterCasing value); };
public System.Windows.Forms.CharacterCasing CharacterCasing { get; set; }
member this.CharacterCasing : System.Windows.Forms.CharacterCasing with get, set
Public Property CharacterCasing As CharacterCasing

Property Value

CharacterCasing

Une des valeurs d'énumération CharacterCasing spécifiant si le contrôle TextBox modifie la casse des caractères.One of the CharacterCasing enumeration values that specifies whether the TextBox control modifies the case of characters. Par défaut, il s’agit de CharacterCasing.Normal.The default is CharacterCasing.Normal.

Exceptions

La valeur assignée à la propriété n'appartient pas à la plage de valeurs valides de l'énumération.A value that is not within the range of valid values for the enumeration was assigned to the property.

Examples

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

Remarks

Vous pouvez utiliser la propriété CharacterCasing pour modifier la casse des caractères selon les besoins de votre application.You can use the CharacterCasing property to change the case of characters as required by your application. Par exemple, vous pouvez modifier la casse de tous les caractères entrés dans un contrôle de TextBox utilisé pour l’entrée de mot de passe en majuscules ou en minuscules pour appliquer une stratégie de mots de passe.For example, you could change the case of all characters entered in a TextBox control used for password entry to uppercase or lowercase to enforce a policy for passwords.

Applies to

See also