RichTextBox.MaxLength Propriedade

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 de Propriedade

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

Exceções

Exemplos

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

Observações

Quando esta propriedade é definida para 0, o comprimento máximo do texto que pode ser introduzido no controlo é de 64 KB de caracteres. Esta propriedade é normalmente usada quando é RichTextBox usado para exibir uma única linha de texto em formato de texto enriquecido (RTF). Pode usar esta propriedade para restringir o comprimento do texto introduzido no controlo para valores como códigos postais e números de telefone, ou para restringir o comprimento do texto inserido quando os dados vão ser inseridos numa base de dados. Pode limitar o texto introduzido no controlo ao comprimento máximo do campo correspondente na base de dados.

Ver também

• MaxLength