RichTextBox.MaxLength Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft die maximale Anzahl an Zeichen ab, die Benutzer in das RichTextBox-Steuerelement eingeben oder einfügen können, oder legt diese fest.

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

Eigenschaftswert

Int32

Die Anzahl der Zeichen, die in das Steuerelement eingegeben werden können. Der Standardwert ist Int32.MaxValue.

Ausnahmen

ArgumentException

Der zugewiesene Eigenschaftswert ist kleiner als 0 (null).

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die MaxLength -Eigenschaft verwendet wird, um zu bestimmen, ob einem RichTextBox Steuerelement zugewiesener Text größer als der der MaxLength Eigenschaft zugewiesene Wert ist. Wenn der Text nicht größer ist, wird im Beispiel die SelectedText -Eigenschaft verwendet, um den Text dem Steuerelement zuzuweisen. Dieses Beispiel erfordert, dass einem Formular ein RichTextBox Steuerelement mit dem Namen richTextBox1hinzugefügt wurde und dass die -Methode im Beispiel mit Text aufgerufen wird, der für den Parameter bereitgestellt wird, der in das Steuerelement eingefügt werden soll. Das Beispiel erfordert auch, dass die MaxLength -Eigenschaft auf einen Wert festgelegt wurde, um den Texteintrag in zu RichTextBoxbeschränken.

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

Hinweise

Wenn diese Eigenschaft auf 0 festgelegt ist, beträgt die maximale Länge des Texts, der in das Steuerelement eingegeben werden kann, 64 KB Zeichen. Diese Eigenschaft wird in der Regel verwendet, wenn eine RichTextBox einzelne Zeile rtf-Text (Rich Text Format) angezeigt wird. Sie können diese Eigenschaft verwenden, um die Länge des in das Steuerelement eingegebenen Texts für Werte wie Postleitzahlen und Telefonnummern einzuschränken oder die Länge des texts einzuschränken, der eingegeben wird, wenn die Daten in eine Datenbank eingegeben werden sollen. Sie können den in das Steuerelement eingegebenen Text auf die maximale Länge des entsprechenden Felds in der Datenbank beschränken.

Hinweis

Im Code können Sie den Wert der -Eigenschaft auf einen Wert festlegen, dessen Text Länge größer als der von der MaxLength -Eigenschaft angegebene Wert ist. Diese Eigenschaft wirkt sich nur auf Text aus, der zur Laufzeit in das Steuerelement eingegeben wird.

Weitere Informationen

• MaxLength