RichTextBox.MaxLength Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece el número máximo de caracteres que el usuario puede escribir o pegar en el control RichTextBox.

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 propiedad

Int32

Número de caracteres que pueden escribirse en el control. El valor predeterminado es Int32.MaxValue.

Excepciones

ArgumentException

El valor asignado a la propiedad es menor que 0.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la MaxLength propiedad para determinar si el texto que se asigna a un RichTextBox control es mayor que el valor asignado a la MaxLength propiedad . Si el texto no es mayor, en el ejemplo se usa la SelectedText propiedad para asignar el texto al control . En este ejemplo se requiere que se haya agregado un RichTextBox control, denominado richTextBox1, a un formulario y que se llame al método del ejemplo con texto proporcionado al parámetro que se va a pegar en el control. El ejemplo también requiere que la propiedad se haya establecido en un valor para limitar la MaxLengthRichTextBoxentrada de texto a .

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

Comentarios

Cuando esta propiedad se establece en 0, la longitud máxima del texto que se puede escribir en el control es de 64 KB de caracteres. Esta propiedad se usa normalmente cuando RichTextBox se usa para mostrar una sola línea de texto enriquecido (RTF). Puede usar esta propiedad para restringir la longitud del texto especificado en el control para valores como códigos postales y números de teléfono, o para restringir la longitud del texto especificado cuando los datos se escriban en una base de datos. Puede limitar el texto especificado en el control a la longitud máxima del campo correspondiente en la base de datos.

Nota:

En el código, puede establecer el valor de la Text propiedad en un valor que tenga una longitud mayor que el valor especificado por la MaxLength propiedad . Esta propiedad solo afecta al texto escrito en el control en tiempo de ejecución.

Consulte también

• MaxLength