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.

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. La valeur par défaut est Int32.MaxValue.

Exceptions

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

Exemples

L’exemple de code suivant montre comment utiliser la MaxLength propriété pour déterminer si le texte affecté à un RichTextBox contrôle est supérieur à la valeur affectée à la MaxLength propriété. Si le texte n’est pas plus grand, l’exemple utilise la SelectedText propriété pour affecter le texte au contrôle. Cet exemple nécessite qu’un RichTextBox contrôle, nommé richTextBox1, ait été ajouté à un formulaire et que la méthode dans l’exemple soit appelée avec du texte fourni au paramètre qui doit être collé dans le contrôle. L’exemple exige également que la MaxLength propriété ait été définie sur une valeur pour limiter l’entrée de texte dans le 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

Lorsque cette propriété est définie sur 0, la longueur maximale du texte pouvant être entré dans le contrôle est de 64 Ko de caractères. Cette propriété est généralement utilisée lorsque le RichTextBox est utilisé pour afficher une seule ligne de texte rtf (Rich Text Format). 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. 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.

S’applique à

Voir aussi