RichTextBox.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 RichTextBox.Gets or sets the maximum number of characters the user can type or paste into the rich text box control.

public:
 virtual property int MaxLength { int get(); void set(int value); };
public override int MaxLength { get; set; }
member this.MaxLength : int with get, set
Public Overrides 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 MaxValue.The default is MaxValue.

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 montre comment utiliser la propriété MaxLength pour déterminer si le texte assigné à un contrôle RichTextBox est plus grand que la valeur assignée à la propriété MaxLength.The following code example demonstrates how to use the MaxLength property to determine if text being assigned to a RichTextBox control is larger than the value assigned to the MaxLength property. Si le texte n’est pas plus grand, l’exemple utilise la propriété SelectedText pour assigner le texte au contrôle.If the text is not larger, the example uses the SelectedText property to assign the text to the control. Cet exemple requiert qu’un contrôle RichTextBox, nommé richTextBox1, ait été ajouté à un formulaire et que la méthode dans l’exemple soit appelée avec le texte fourni au paramètre qui doit être collé dans le contrôle.This example requires that a RichTextBox control, named richTextBox1, has been added to a form and that the method in the example is called with text supplied to the parameter that is to be pasted into the control. L’exemple requiert également que la propriété MaxLength ait été définie sur une valeur pour limiter l’entrée de texte dans le RichTextBox.The example also requires that the MaxLength property has been set to a value to limit text entry into the RichTextBox.

private:
   void AddMyText( String^ textToAdd )
   {
      // Determine if the text to add is larger than the max length property.
      if ( textToAdd->Length > richTextBox1->MaxLength )
         // Alert user text is too large.
         MessageBox::Show( "The text is too large to add to the RichTextBox" ); // Add the text to be added to the control.
      else
         richTextBox1->SelectedText = textToAdd;
   }
private void AddMyText(string textToAdd)
{
    // Determine if the text to add is larger than the max length property.
    if (textToAdd.Length > richTextBox1.MaxLength)
        // Alert user text is too large.
        MessageBox.Show("The text is too large to addo to the RichTextBox");
    else
        // Add the text to be added to the control.
        richTextBox1.SelectedText = textToAdd;
}
Private Sub AddMyText(ByVal textToAdd As String)
    ' Determine if the text to add is larger than the max length property.
    If textToAdd.Length > richTextBox1.MaxLength Then
        ' Alert user text is too large.
        MessageBox.Show("The text is too large to addo to the RichTextBox")
        ' Add the text to be added to the control.
    Else
        richTextBox1.SelectedText = textToAdd
    End If
End Sub

Remarques

Quand cette propriété a la valeur 0, la longueur maximale du texte qui peut être entré dans le contrôle est de 64 Ko de caractères.When this property is set to 0, the maximum length of the text that can be entered in the control is 64 KB of characters. Cette propriété est généralement utilisée lorsque le RichTextBox est utilisé pour afficher une seule ligne de texte au format RTF (Rich Text Format).This property is typically used when the RichTextBox is used to display a single line of rich text format (RTF) text. 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 à

Voir aussi