TextBoxBase.MaxLength Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit le nombre maximal de caractères que l'utilisateur peut taper ou coller dans le contrôle zone de texte.

public:
 virtual property int MaxLength { int get(); void set(int value); };

public virtual int MaxLength { get; set; }

member this.MaxLength : int with get, set

Public Overridable Property MaxLength As Integer

Valeur de propriété

Int32

Nombre maximal de caractères pouvant être entré dans le contrôle. La valeur par défaut est 32767.

Exceptions

ArgumentOutOfRangeException

La valeur assignée à la propriété est inférieure à 0.

Exemples

L’exemple de code suivant utilise la classe dérivée, TextBoxpour créer une zone de texte utilisée pour accepter un mot de passe. Cet exemple utilise la CharacterCasing propriété pour modifier tous les caractères tapés en majuscules 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 uppercase.
      textBox1->CharacterCasing = CharacterCasing::Upper;
      // 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 uppercase.
    textBox1.CharacterCasing = CharacterCasing.Upper;
    // 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 uppercase.
    textBox1.CharacterCasing = CharacterCasing.Upper
    ' Align the text in the center of the TextBox control.
    textBox1.TextAlign = HorizontalAlignment.Center
End Sub

Remarques

Vous pouvez utiliser cette propriété pour limiter la longueur du texte entré dans le contrôle pour les valeurs telles que les codes postaux et les numéros de téléphone, ou pour restreindre la longueur du texte entré lorsque les données doivent être entrées dans une base de données. Vous pouvez limiter le texte entré dans le contrôle à la longueur maximale du champ correspondant dans la base de données.

Notes

Dans le code, vous pouvez définir la valeur de la Text propriété sur une valeur dont la longueur est supérieure à la valeur spécifiée par la MaxLength propriété. Cette propriété affecte uniquement le texte entré dans le contrôle au moment de l’exécution.