RichTextBox.MaxLength Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define o número máximo de caracteres que o usuário pode digitar ou colar no controle da caixa 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

Valor da propriedade

Int32

O número de caracteres que podem ser inseridos no controle. O padrão é Int32.MaxValue.

Exceções

ArgumentException

O valor atribuído à propriedade é menor que 0.

Exemplos

O exemplo de código a seguir demonstra como usar a propriedade para determinar se o MaxLength texto atribuído a um RichTextBox controle é maior do que o valor atribuído à MaxLength propriedade. Se o texto não for maior, o exemplo usará a SelectedText propriedade para atribuir o texto ao controle. Este exemplo exige que um RichTextBox controle, chamado richTextBox1, tenha sido adicionado a um formulário e que o método no exemplo seja chamado com texto fornecido para o parâmetro que deve ser colado no controle . O exemplo também exige que a MaxLength propriedade tenha sido definida como um valor para limitar a entrada de texto no 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

Comentários

Quando essa propriedade é definida como 0, o comprimento máximo do texto que pode ser inserido no controle é de 64 KB de caracteres. Normalmente, essa propriedade é usada quando o RichTextBox é usado para exibir uma única linha de texto de formato de rich text (RTF). Você pode usar essa propriedade para restringir o comprimento do texto inserido no controle para valores como códigos postais e números de telefone, ou para restringir o comprimento do texto inserido quando os dados devem ser inseridos em um banco de dados. Você pode limitar o texto inserido no controle ao comprimento máximo do campo correspondente no banco de dados.

Observação

No código, você pode definir o valor da Text propriedade como um valor que tem um comprimento maior que o valor especificado pela MaxLength propriedade . Essa propriedade afeta apenas o texto inserido no controle em tempo de execução.

Confira também

• MaxLength