TextBoxBase.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 de caixa 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 da propriedade

Int32

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

Exceções

ArgumentOutOfRangeException

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

Exemplos

O exemplo de código a seguir usa a classe TextBoxderivada para criar uma caixa de texto usada para aceitar uma senha. Este exemplo usa a CharacterCasing propriedade para alterar todos os caracteres digitado para maiúsculas e a MaxLength propriedade para restringir o comprimento da senha a oito caracteres. Este exemplo também usa a TextAlign propriedade para centralizar a senha no TextBox controle.

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

Comentários

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.