RichTextBox.MaxLength Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia maksymalną liczbę znaków, które użytkownik może wpisać lub wkleić do kontrolki pola tekstowego sformatowanego.

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

Wartość właściwości

Int32

Liczba znaków, które można wprowadzić w kontrolce. Wartość domyślna to Int32.MaxValue.

Wyjątki

ArgumentException

Wartość przypisana do właściwości jest mniejsza niż 0.

Przykłady

W poniższym przykładzie kodu pokazano, jak za pomocą MaxLength właściwości określić, czy tekst przypisany do RichTextBox kontrolki jest większy niż wartość przypisana MaxLength do właściwości. Jeśli tekst nie jest większy, w przykładzie użyto SelectedText właściwości , aby przypisać tekst do kontrolki. W tym przykładzie do formularza dodano kontrolkę RichTextBox o nazwie richTextBox1, a metoda w przykładzie jest wywoływana z tekstem dostarczonym do parametru, który ma zostać wklejony do kontrolki. Przykład wymaga również, MaxLength aby właściwość została ustawiona na wartość, aby ograniczyć wprowadzanie tekstu do obiektu 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

Uwagi

Jeśli ta właściwość ma wartość 0, maksymalna długość tekstu, który można wprowadzić w kontrolce, wynosi 64 KB znaków. Ta właściwość jest zwykle używana, gdy RichTextBox element jest używany do wyświetlania pojedynczego wiersza tekstu sformatowanego (RTF). Za pomocą tej właściwości można ograniczyć długość tekstu wprowadzonego w kontrolce dla wartości, takich jak kody pocztowe i numery telefonów, lub ograniczyć długość tekstu wprowadzonego podczas wprowadzania danych w bazie danych. Możesz ograniczyć tekst wprowadzony do kontrolki do maksymalnej długości odpowiedniego pola w bazie danych.

Uwaga

W kodzie można ustawić wartość Text właściwości na wartość o długości większej niż wartość określona MaxLength przez właściwość. Ta właściwość wpływa tylko na tekst wprowadzony w kontrolce w czasie wykonywania.

Zobacz też

• MaxLength