Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês
Esta documentação foi arquivada e não está sendo atualizada.

Propriedade TextBoxBase.MaxLength

Obtém ou define o número máximo de caracteres que o usuário digita ou cola no controle de caixa de texto.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (em System.Windows.Forms.dll)

public virtual int MaxLength { get; set; }

Valor de propriedade

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

ExceçãoCondição
ArgumentOutOfRangeException

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

Você pode usar essa propriedade para restringir o tamanho do texto inserido no controle para valores sistema autônomo códigos postais e números de telefone ou para restringir o comprimento do texto inserido quando sistema autônomo dados sejam inseridos em um banco de dados.Você pode limitar o texto inserido no controle ao tamanho máximo do campo correspondente no banco de dados.

ObservaçãoObservação:

No código, você pode conjunto o valor da Text propriedade para um valor que tenha um tamanho maior do que o valor especificado pela MaxLength propriedade. Esta propriedade afeta somente o texto inserido no controle em time de execução.

Windows NT 4.0, Windows 2000, Windows 2000 Professional, Windows 2000 Server, Windows 2000 Advanced Server, Windows XP Home Edition, Windows XP Professional x64 Edition, Windows Server 2003 Observação Zoom, Para Cima e Ampliar:

Para controles de caixa de texto única linha, se o MaxLength propriedade é conjunto como 0, o número máximo de caracteres que o usuário pode inserir é 2147483646 ou um valor com base na memória disponível, a que for menor. Para controles de caixa de texto de várias linhas, o número máximo de caracteres que o usuário pode inserir é de 4294967295 ou um valor com base na memória disponível, o que for menor.

Windows Millennium Edition Observação Zoom, Para Cima e Ampliar:

Para controles de caixa de texto única linha, se o MaxLength propriedade é conjunto como 0, o número máximo de caracteres que o usuário pode inserir é 32.766 ou um valor com base na memória disponível, a que for menor. Para controles de caixa de texto de várias linhas, o número máximo de caracteres que o usuário pode inserir é de 65.535 ou um valor com base na memória disponível, o que for menor.

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

publicvoid 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 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.set_MaxLength(8);
    // Assign the asterisk to be the password character.
    textBox1.set_PasswordChar('*');
    // Change all text entered to be uppercase.
    textBox1.set_CharacterCasing(CharacterCasing.Upper);
    // Align the text in the center of the TextBox control.
    textBox1.set_TextAlign(HorizontalAlignment.Center);
} //CreateMyPasswordTextBox


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

o.NET Framework e.NET Compact Framework não oferecem suporte a todas as versões de cada plataforma. Para obter uma lista de versões suportadas, consulte Requisitos de sistema do .NET framework.

.NET Framework

Compatível com: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatível com: 3.5, 2.0, 1.0
Mostrar: