RichTextBox.MaxLength Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Получает или задает наибольшее число символов, которое можно ввести или вставить в поле форматированного текста элемента управления.

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

Значение свойства

Int32

Число символов, которое можно ввести в элемент управления. Значение по умолчанию — Int32.MaxValue.

Исключения

ArgumentException

Значение, назначенное свойству, меньше 0.

Примеры

В следующем примере кода показано, как использовать MaxLength свойство , чтобы определить, больше ли размер текста, присваиваемого RichTextBox элементу управления, чем значение, присвоенное свойству MaxLength . Если текст не больше, в примере используется SelectedText свойство для назначения текста элементу управления . В этом примере требуется, чтобы элемент управления с именем richTextBox1был добавлен в форму и чтобы метод в примере вызывался с текстомRichTextBox, предоставленным параметру, который должен быть вставлен в элемент управления . В примере также требуется, чтобы свойству MaxLength было присвоено значение , чтобы ограничить ввод текста в 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

Комментарии

Если для этого свойства задано значение 0, максимальная длина текста, который можно ввести в элементе управления, составляет 64 КБ символов. Это свойство обычно используется, когда RichTextBox используется для отображения одной строки текста в формате RTF. Это свойство можно использовать для ограничения длины текста, введенного в элементе управления для таких значений, как почтовые индексы и номера телефонов, или для ограничения длины текста, введенного при вводе данных в базу данных. Текст, введенный в элементе управления, можно ограничить максимальной длиной соответствующего поля в базе данных.

Примечание

В коде можно задать значение Text свойства, длина которого превышает значение, заданное свойством MaxLength . Это свойство влияет только на текст, введенный в элемент управления во время выполнения.

См. также раздел

• MaxLength