TextBoxBase.MaxLength Propriété

Définition

Obtient ou définit le nombre maximal de caractères que l'utilisateur peut taper ou coller dans le contrôle zone de texte.Gets or sets the maximum number of characters the user can type or paste into the text box control.

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é

Nombre maximal de caractères pouvant être entré dans le contrôle.The number of characters that can be entered into the control. La valeur par défaut est 32767.The default is 32767.

Exceptions

La valeur assignée à la propriété est inférieure à 0.The value assigned to the property is less than 0.

Exemples

L’exemple de code suivant utilise la classe dérivée, TextBox, pour créer une zone de texte utilisée pour accepter un mot de passe.The following code example uses the derived class, TextBox, to create a text box that is used to accept a password. Cet exemple utilise la propriété CharacterCasing pour remplacer tous les caractères tapés par des majuscules 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 uppercase 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 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 limiter la longueur du texte entré lorsque les données doivent être entrées dans une base de données.You can use this property to restrict the length of text entered in the control for values such as postal codes and telephone numbers, or to restrict the length of text entered when the data is to be entered in a database. Vous pouvez limiter le texte entré dans le contrôle à la longueur maximale du champ correspondant dans la base de données.You can limit the text entered into the control to the maximum length of the corresponding field in the database.

Notes

Dans le code, vous pouvez définir la valeur de la propriété Text sur une valeur dont la longueur est supérieure à la valeur spécifiée par la propriété MaxLength.In code, you can set the value of the Text property to a value that has a length greater than the value specified by the MaxLength property. Cette propriété affecte uniquement le texte entré dans le contrôle au moment de l’exécution.This property only affects text entered into the control at run time.

S’applique à