TextBoxBase.MaxLength TextBoxBase.MaxLength TextBoxBase.MaxLength TextBoxBase.MaxLength Property

Definición

Obtiene o establece el número máximo de caracteres que el usuario puede escribir o pegar en el control de cuadro de texto.Gets or sets the maximum number of characters the user can type or paste into the text box control.

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

Número de caracteres que pueden escribirse en el control.The number of characters that can be entered into the control. El valor predeterminado es 32767.The default is 32767.

Excepciones

El valor asignado a la propiedad es menor que 0.The value assigned to the property is less than 0.

Ejemplos

En el ejemplo de código siguiente se usa la TextBoxclase derivada,, para crear un cuadro de texto que se usa para aceptar una contraseña.The following code example uses the derived class, TextBox, to create a text box that is used to accept a password. En este ejemplo se CharacterCasing usa la propiedad para cambiar todos los caracteres que se escriben a mayúsculas y la MaxLength propiedad para restringir la longitud de la contraseña a ocho caracteres.This example uses the CharacterCasing property to change all characters typed to uppercase and the MaxLength property to restrict the password length to eight characters. En este ejemplo también se TextAlign usa la propiedad para centrar la TextBox contraseña en el control.This example also uses the TextAlign property to center the password in the 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 escrito en el control para valores como códigos postales y números de teléfono, o para restringir la longitud del texto introducido cuando los datos se van a escribir en una base de datos.You can use this property to restrict the length of text entered in the control for values such as postal codes and telephone numbers, or to restrict the length of text entered when the data is to be entered in a database. Puede limitar el texto escrito en el control a la longitud máxima del campo correspondiente en la base de datos.You can limit the text entered into the control to the maximum length of the corresponding field in the database.

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.In code, you can set the value of the Text property to a value that has a length greater than the value specified by the MaxLength property. Esta propiedad solo afecta al texto escrito en el control en tiempo de ejecución.This property only affects text entered into the control at run time.

Se aplica a