TextBoxBase.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 de cuadro de texto.

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

public virtual int MaxLength { get; set; }

member this.MaxLength : int with get, set

Public Overridable Property MaxLength As Integer

Valor de propiedad

Int32

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

Excepciones

ArgumentOutOfRangeException

El valor asignado a la propiedad es menor que 0.

Ejemplos

En el ejemplo de código siguiente se usa la clase derivada , TextBoxpara crear un cuadro de texto que se usa para aceptar una contraseña. En este ejemplo se usa la CharacterCasing propiedad para cambiar todos los caracteres con tipo en mayúsculas y la MaxLength propiedad para restringir la longitud de la contraseña a ocho caracteres. En este ejemplo también se usa la TextAlign propiedad para centrar la contraseña en el TextBox control .

public:
   void CreateMyPasswordTextBox()
   {
      // Create an instance of the TextBox control.
      TextBox^ textBox1 = gcnew TextBox;
      // Set the maximum length of text in the control to eight.
      textBox1->MaxLength = 8;
      // Assign the asterisk to be the password character.
      textBox1->PasswordChar = '*';
      // Change all text entered to be uppercase.
      textBox1->CharacterCasing = CharacterCasing::Upper;
      // Align the text in the center of the TextBox control.
      textBox1->TextAlign = HorizontalAlignment::Center;
   }

public void CreateMyPasswordTextBox()
 {
    // Create an instance of the TextBox control.
    TextBox textBox1 = new TextBox();
    // Set the maximum length of text in the control to eight.
    textBox1.MaxLength = 8;
    // Assign the asterisk to be the password character.
    textBox1.PasswordChar = '*';
    // Change all text entered to be uppercase.
    textBox1.CharacterCasing = CharacterCasing.Upper;
    // Align the text in the center of the TextBox control.
    textBox1.TextAlign = HorizontalAlignment.Center;
 }

Public Sub CreateMyPasswordTextBox()
    ' Create an instance of the TextBox control.
    Dim textBox1 As New TextBox()
    ' Set the maximum length of text in the control to eight.
    textBox1.MaxLength = 8
    ' Assign the asterisk to be the password character.
    textBox1.PasswordChar = "*"c
    ' Change all text entered to be uppercase.
    textBox1.CharacterCasing = CharacterCasing.Upper
    ' Align the text in the center of the TextBox control.
    textBox1.TextAlign = HorizontalAlignment.Center
End Sub

Comentarios

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 se escriban los datos en una base de datos. Puede limitar el texto escrito 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.