RichTextBox.MaxLength Właściwość
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
Liczba znaków, które można wprowadzić w kontrolce. Wartość domyślna to Int32.MaxValue.
Wartość przypisana do właściwości jest mniejsza niż 0.
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
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.
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 |
Opinia o produkcie .NET
.NET to projekt typu open source. Wybierz link, aby przekazać opinię: