RichTextBox.MaxLength Właściwość

Definicja

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

public override int MaxLength { get; set; }

Wartość właściwości

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

Wyjątki

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 addo to the RichTextBox");
    else
        // Add the text to be added to the control.
        richTextBox1.SelectedText = textToAdd;
}

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.

Dotyczy

Produkt Wersje
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Zobacz też