RichTextBox.MaxLength-Eigenschaft

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

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Overrides Property MaxLength As Integer
'Usage
Dim instance As RichTextBox
Dim value As Integer

value = instance.MaxLength

instance.MaxLength = value

public override int MaxLength { get; set; }

public:
virtual property int MaxLength {
    int get () override;
    void set (int value) override;
}

/** @property */
public int get_MaxLength ()

/** @property */
public void set_MaxLength (int value)

public override function get MaxLength () : int

public override function set MaxLength (value : int)

Eigenschaftenwert

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

Ausnahmen

Hinweise

Wenn diese Eigenschaft auf 0 (null) festgelegt ist, wird die maximale Textlänge für das Steuerelement auf 64 KB Zeichen beschränkt. Diese Eigenschaft wird üblicherweise verwendet, wenn die RichTextBox zum Anzeigen einer einzelnen Textzeile in RTF (Rich Text Format) verwendet wird. Sie können mit dieser Eigenschaft die Länge des in das Steuerelement eingegebenen Texts für Werte wie Postleitzahlen und Telefonnummern oder für Daten, die in eine Datenbank eingegeben werden sollen, einschränken. Sie können den in das Steuerelement eingegebenen Text auf die maximale Länge des entsprechenden Felds in der Datenbank beschränken.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie mit der MaxLength-Eigenschaft bestimmt wird, ob der einem RichTextBox-Steuerelement zugeordnete Text größer als der Wert ist, der der MaxLength-Eigenschaft zugeordnet wurde. Wenn die Länge des Texts den Wert nicht überschreitet, wird dem Steuerelement im Beispiel mithilfe der SelectedText-Eigenschaft Text zugeordnet. Für dieses Beispiel ist es erforderlich, dass einem Formular ein RichTextBox-Steuerelement mit der Bezeichnung richTextBox1 hinzugefügt wurde und die Methode im Beispiel mit dem im Parameter bereitgestellten Text aufgerufen wird, der dem Steuerelement hinzugefügt werden soll. Für das Beispiel ist es zudem erforderlich, dass die MaxLength-Eigenschaft auf einen Wert festgelegt wurde, um die Texteingabe in der RichTextBox zu begrenzen.

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

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:
   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.get_Length() > richTextBox1.get_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.set_SelectedText(textToAdd);
    }
} //AddMyText 

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

RichTextBox-Klasse
RichTextBox-Member
System.Windows.Forms-Namespace
MaxLength