RichTextBox.MaxLength Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta il numero massimo di caratteri che l’utente può digitare nel controllo casella di testo RTF.

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

Valore della proprietà

Int32

Numero di caratteri che può essere immesso nel controllo. Il valore predefinito è Int32.MaxValue.

Eccezioni

ArgumentException

Il valore assegnato alla proprietà è minore di zero.

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare la MaxLength proprietà per determinare se il testo assegnato a un RichTextBox controllo è maggiore del valore assegnato alla MaxLength proprietà. Se il testo non è più grande, nell'esempio viene utilizzata la SelectedText proprietà per assegnare il testo al controllo . In questo esempio è necessario che un RichTextBox controllo denominato richTextBox1sia stato aggiunto a una maschera e che il metodo nell'esempio venga chiamato con il testo fornito al parametro da incollare nel controllo . L'esempio richiede inoltre che la MaxLength proprietà sia stata impostata su un valore per limitare la RichTextBoxvoce di testo in .

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

Commenti

Quando questa proprietà è impostata su 0, la lunghezza massima del testo che può essere immesso nel controllo è di 64 KB di caratteri. Questa proprietà viene in genere utilizzata quando RichTextBox viene utilizzato per visualizzare una singola riga di testo RTF (Rich Text Format). È possibile utilizzare questa proprietà per limitare la lunghezza del testo immesso nel controllo per valori quali codici postali e numeri di telefono oppure per limitare la lunghezza del testo immesso quando i dati devono essere immessi in un database. È possibile limitare il testo immesso nel controllo alla lunghezza massima del campo corrispondente nel database.

Nota

Nel codice è possibile impostare il valore della Text proprietà su un valore con lunghezza maggiore del valore specificato dalla MaxLength proprietà . Questa proprietà influisce solo sul testo immesso nel controllo in fase di esecuzione.

Vedi anche

• MaxLength