Tutorial de controle VB.Net TEXTBOX: propriedades com exemplo

โšก Resumo Inteligente

TextoBox Os controles em VB.Net aceitam entrada do usuรกrio em um Windows Crie e exponha propriedades como Multiline, PasswordChar, MaxLength e ReadOnly para definir como o texto รฉ inserido, ocultado, limitado ou bloqueado em tempo de execuรงรฃo.

  • ๐Ÿงฉ Objetivo principal: O textoBox O controle captura a entrada do usuรกrio em uma ou vรกrias linhas em um Windows Formulรกrio durante a execuรงรฃo.
  • ๐Ÿ”ค Propriedades-chave: TextAlign, ScrollBars, Multiline, MaxLength, Readonly e PasswordChar personalizam o comportamento do controle.
  • ๐Ÿ” Mascaramento de senha: Definir PasswordChar como * oculta os caracteres ร  medida que o usuรกrio digita, mantendoping Informaรงรตes confidenciais privadas.
  • ๐Ÿ“„ Vรกrias linhas: Ative a propriedade Multiline como True e, em seguida, use ControlChars.NewLine para dividir o texto em linhas separadas.
  • ๐Ÿ”ข Valores numรฉricos: Converta a string com Integer.Parse antes de processar qualquer texto.Box Entrada como um nรบmero.
  • ๐Ÿค– Assistรชncia de IA: GitHub Copilot e Visual Studio 2026 IntelliCode Pode gerar manipuladores de eventos e validar entradas digitadas.

Texto em VB.NetBox Propriedades de controle e exemplos

O que รฉ textoBox Ao controle?

O textoBox O controle permite que vocรช insira texto em seu formulรกrio durante o tempo de execuรงรฃo. A configuraรงรฃo padrรฃo รฉ aceitar apenas uma linha de texto, mas vocรช pode modificรก-la para aceitar vรกrias linhas. Vocรช pode atรฉ incluir barras de rolagem em seu textoBox Ao controle.

TextoBox Propriedades

A seguir estรฃo as propriedades mais comuns do Visual Basic TextBox ao controle:

  • TextAlignโ€“ para definir o alinhamento do texto
  • ScrollBarsโ€“ para adicionar barras de rolagem, tanto verticais quanto horizontais
  • Multilineโ€“ para definir o textoBox Controle para permitir mรบltiplas linhas
  • Comprimento mรกximoโ€“ para especificar o nรบmero mรกximo de caracteres o TextoBox O controle aceitarรก
  • รndiceโ€“ para especificar o รญndice da matriz de controle
  • Os utilizadores da app Smart Spaces com Google Wallet podem usufruir de acesso mรณvel sem contacto com qualquer leitor HIDยฎ Signoโ„ข habilitado com NFC.โ€“ para habilitar o controle de caixa de texto
  • Somente leituraโ€“ se definido como verdadeiro, vocรช poderรก usar o textoBox Se o controle estiver definido como falso, vocรช nรฃo poderรก usar o texto.Box Ao controle.
  • Seleรงรฃo Iniciarโ€“ para definir ou obter o ponto de partida para o TextoBox Ao controle.
  • comprimento da seleรงรฃoโ€“ para definir ou obter o nรบmero de caracteres que foram selecionados no TextoBox Ao controle.
  • Texto selecionadoโ€“ retorna o TextoBox Controle que estรก atualmente selecionado.

TextoBox Eventos

O propรณsito dos eventos รฉ tornar o TextoBox O controle responde ร s aรงรตes do usuรกrio, como clique, clique duplo ou alteraรงรฃo no alinhamento do texto. Aqui estรฃo os eventos comuns para o TextoBox Ao controle:

  • AutoSizeChangedโ€“ Acionado por uma alteraรงรฃo na propriedade AutoSize.
  • Somente leitura alteradaโ€“ Acionado por uma alteraรงรฃo do valor da propriedade ReadOnly.
  • Cliqueโ€“ Acionado por um clique no textoBox Ao controle.

Como criar um textoBox

Siga estes passos para adicionar seu primeiro texto.Box controle para um Windows Criar e exibir uma mensagem de saudaรงรฃo em tempo de execuรงรฃo.

Passo 1) Para criar um textoBox, arraste o TextoBox controle da caixa de ferramentas para o Windows Formato:

TextoBox controle adicionado ao Windows Superfรญcie de design de forma

Passo 2)

  1. Clique no textoBox Controle que vocรช adicionou ao formulรกrio.
  2. Vรก para a seรงรฃo Propriedades localizada na parte inferior esquerda da tela. Altere o nome da caixa de texto de TextoBox1 para OlรกTextoBox:

Renomeando o textoBox para HelloTextBox na janela Propriedades

Passo 3) Adicione o seguinte cรณdigo para adicionar texto ao controle:

Private Sub Form1_Load(sender As Object, e As EventArgs) Handles MyBase.Load
        'Add text to the control
         HelloTextBox.Text = "Hello. Welcome to Guru99!"
  End Sub

Passo 4) Agora vocรช pode executar o cรณdigo clicando no botรฃo Iniciar localizado na barra superior:

O botรฃo Iniciar na barra de ferramentas do Visual Studio รฉ usado para executar o projeto.

Etapa 5) Vocรช deverรก obter o seguinte formulรกrio:

Executando o formulรกrio que exibe "Olรก. Bem-vindo(a) ao" Guru99! no textoBox

Aqui estรก uma captura de tela do cรณdigo completo acima:

Complete o cรณdigo Form1_Load que define HelloText.Box texto

Explicaรงรฃo do cรณdigo:

  1. Criando uma classe pรบblica chamada Form1.
  2. Criando um subprocedimento denominado Form1_Load. Serรก chamado quando o formulรกrio for carregado.
  3. Um comentรกrio. O compilador VB.Net irรก ignorar isso.
  4. Finalize o subprocedimento.
  5. Termine a aula.

Propriedade PasswordChar

ร€s vezes, vocรช quer que uma caixa de texto seja usada para digitarping uma senha. Isso significa que tudo o que for digitado nessa caixa de texto deve permanecer confidencial. Isso รฉ possรญvel com VB.Net. Isso pode ser feito usando o SenhaChar propriedade que nos permite usar qualquer caractere que vocรช desejar. Vamos demonstrar isso usando um exemplo:

Comece criando um novo projeto. Arraste dois textosBox Controles, dois Labels e um Button no formulรกrio. Altere os textos nos dois labels e no botรฃo para o seguinte:

Design de formulรกrio de login com rรณtulos para nome de usuรกrio, senha e texto.Box controles e botรฃo de login

Clique na caixa de texto ao lado do rรณtulo Nome de usuรกrio e vรก para a seรงรฃo Propriedades localizada na parte inferior esquerda da janela. Dรช a ele o nome UsernameField.

Definindo a propriedade Nome do texto do nome de usuรกrioBox para o campo de nome de usuรกrio

Faรงa o mesmo para o textoBox Controle prรณximo ao rรณtulo Senha, dando-lhe o nome de PasswordField.

Definindo a propriedade Nome do texto da senhaBox para o campo de senha

Agora vocรช deve criar o texto PasswordFieldBox Controle show * para cada caractere digitado nele. Adicione o seguinte cรณdigo:

Private Sub PasswordField_TextChanged(sender As Object, e As EventArgs) Handles PasswordField.TextChanged
       PasswordField.PasswordChar = "*"
End Sub

Agora, execute o cรณdigo clicando no botรฃo Iniciar. Um formulรกrio aparecerรก.

Digite o nome de usuรกrio e a senha e observe o que acontece. Vocรช deverรก ver o seguinte:

Formulรกrio de login em execuรงรฃo com o campo de senha oculto por asteriscos.

O nome de usuรกrio รฉ mostrado, mas a senha foi ocultada. Aqui estรก o cรณdigo acima:

Cรณdigo completo do manipulador de eventos PasswordChar em VB.Net para PasswordField_TextChanged

Explicaรงรฃo do cรณdigo:

  1. Criando uma classe chamada Form1.
  2. Criando um sub-procedimento chamado PasswordField_TextChanged(). Ele serรก chamado quando o formulรกrio for carregado.
  3. Usando a propriedade PasswordChar para mostrar * conforme um usuรกrio digita a senha.
  4. Finalizando o subprocedimento.
  5. Terminando a aula.

Nova linha no textoBox

Por padrรฃo, vocรช sรณ pode criar uma linha de texto em uma caixa de texto. Existem duas maneiras pelas quais podemos conseguir isso. Vamos discuti-los.

Arraste e solte um textoBox Controle o seu formulรกrio. Dรช um nome ao controle. GuruBem vinda.

TextoBox renomeado para GuruA palavra "Bem-vindo" รฉ exibida na superfรญcie do formulรกrio.

Clique novamente no controle da caixa de texto e mova o cursor do mouse para a seรงรฃo Propriedades. Altere o valor da propriedade Multiline para True.

A propriedade Multilinhas deve estar definida como Verdadeira na janela Propriedades.

Alternativamente, vocรช pode definir a propriedade Multiline como verdadeira em seu cรณdigo da seguinte forma:

GuruBem-vindo.Multilinhas = Verdadeiro

Adicione o seguinte cรณdigo:

 Private Sub Form1_Load(sender As Object, e As EventArgs) Handles MyBase.Load

        GuruWelcome.Multiline = True

        GuruWelcome.Text = "Line 1"

        GuruWelcome.Text = GuruWelcome.Text & ControlChars.NewLine & "Line 2"

    End Sub

Apรณs a execuรงรฃo, as duas linhas de texto serรฃo separadas.

Forma de execuรงรฃo mostrando a Linha 1 e a Linha 2 separadas por uma nova linha.

Explicaรงรฃo de Code:

  1. Criando uma classe chamada Form1.
  2. Criando uma sub-rotina chamada Form1_Load().
  3. Defina a propriedade Multiline como True. A caixa de texto poderรก conter mais de uma linha.
  4. Adicionando a primeira linha de texto ร  caixa de texto.
  5. Adicionando a segunda linha de texto ร  caixa de texto. A propriedade ControlChars.NewLine nos ajuda a separar as duas linhas.
  6. Finalizando a sub-rotina.
  7. Terminando a aula.

Recuperando Valores Inteiros

Em VB.Net, tudo รฉ tratado como uma string. Isso significa que vocรช lรช um nรบmero inteiro da caixa de texto como uma string e, em seguida, o converte para um nรบmero inteiro. Normalmente, isso รฉ feito usando o mรฉtodo Integer.Parse().

Para demonstrar isso, crie um novo controle de caixa de texto mais um botรฃo. Dรช ร  caixa de texto o nome idade. Dรช ao botรฃo o nome de Button1. Vocรช deverรก ter a seguinte interface:

TextoBox idade indicada e um botรฃo "Mostrar idade" colocado no formulรกrio

Adicione o seguinte cรณdigo:

Private Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.Click
        Dim x As Integer
        x = Integer.Parse(age.Text)
        MessageBox.Show(x)

Execute o cรณdigo e insira sua idade na caixa de texto. Clique no botรฃo Mostrar idade. Vocรช deverรก ver o seguinte:

Exibir caixa de diรกlogo de idade mostrando o valor inteiro inserido em uma mensagem.Box

O valor inserido รฉ retornado em uma mensagemBox.

Cรณdigo completo do botรฃo Button1_Click que analisa o texto da idade.Box valor para um nรบmero inteiro

Explicaรงรฃo de Code:

  1. Criando uma classe chamada Form1.
  2. Criando um subprocedimento chamado Button1_Click. Ele serรก chamado quando o botรฃo for clicado.
  3. Definindo uma variรกvel inteira chamada x.
  4. Convertendo o valor lido da caixa de texto chamada idade em um nรบmero inteiro.
  5. Exibindo o valor convertido na etapa acima em uma mensagemBox.
  6. Finalizando o subprocedimento.

Texto somente leituraBox

Vocรช pode tornar uma caixa de texto somente leitura. Isso significa que o usuรกrio nรฃo poderรก modificar o valor exibido na caixa de texto. Para fazer isso, defina a propriedade ReadOnly como True. Para demonstrar isso, crie uma nova caixa de texto e dรช a ela o nome guru99. Adicione o seguinte cรณdigo:

Private Sub guru99_TextChanged(sender As Object, e As EventArgs) Handles guru99.TextChanged

        guru99.Text = "welcome to Guru99"

        guru99.ReadOnly = True

    End Sub

O cรณdigo deve retornar o seguinte:

Texto somente leituraBox executando com texto bem-vindo ao Guru99 que nรฃo podem ser editados

Aqui estรก o cรณdigo:

Cรณdigo completo do manipulador de eventos guru99_TextChanged definindo ReadOnly como True

Explicaรงรฃo de Code:

  1. Criando uma classe chamada Form1.
  2. Criando uma sub-rotina chamada guru99_TextChanged.
  3. Adicionando texto ร  caixa de texto chamada guru99.
  4. Defina a propriedade ReadOnly da caixa de texto como True. Isso torna o texto na caixa de texto imutรกvel.
  5. Finalizando o subprocedimento.
  6. Terminando a aula.

Propriedade MaxLength

A propriedade MaxLength pode ajudar vocรช a definir o nรบmero mรกximo de palavras ou caracteres que a caixa de texto permitirรก. Para demonstrar isso, crie um TextBox O controle deve ser nomeado com o nome fullName. Adicione o seguinte cรณdigo:

Private Sub fullName_TextChanged(sender As Object, e As EventArgs) Handles fullName.TextChanged

        fullName.MaxLength = 8

    End Sub

Execute o cรณdigo e tente digitar seu nome completo. Vocรช nรฃo poderรก digitar mais de 8 caracteres, incluindo espaรงos em branco:

Texto de comprimento mรกximoBox limitar a entrada a oito caracteres em tempo de execuรงรฃo

O cรณdigo:

Cรณdigo completo fullName_TextChanged que define MaxLength como 8

Code Explicaรงรฃo:

  1. Criando uma classe chamada Form1.
  2. Criando um subprocedimento denominado fullName_TextChanged.
  3. Fazer com que a caixa de texto fullName aceite no mรกximo apenas 8 caracteres.
  4. Finalizando o subprocedimento.
  5. Terminando a aula.

Perguntas Frequentes

A TextoBox Armazena texto simples com limite de 64 mil caracteres e baixo consumo de recursos, ideal para entrada de formulรกrios. Texto ricoBox Suporta fontes, cores, imagens e comprimento ilimitado, sendo assim adequado para editores que precisam de conteรบdo estilizado ou de formato longo.

Manipule o evento KeyPress e defina e.Handled = True sempre que Char.IsDigit e Char.IsControl Ambos retornam False. Para validaรงรฃo segura de colagem, use o evento Validating com Inteiro.TryParse e mostrar feedback atravรฉs de um ErrorProvider.

Sim. Travas deslizantes portรกteis Copiloto do GitHub Lรช o cรณdigo do formulรกrio circundante e sugere manipuladores completos para os eventos TextChanged, KeyPress ou Validating. RevVisualize o cรณdigo gerado, adicione verificaรงรตes de valores nulos e ajuste os nomes antes de aceitรก-lo para que corresponda ร s convenรงรตes do seu projeto.

Visual Studio 2026 IntelliCode classifica o provรกvel prรณximo membro no TextBox instรขncias, completa automaticamente atribuiรงรตes de propriedades como Multiline ou MaxLength e sugere ediรงรตes de linha inteira com base em padrรตes aprendidos a partir de milhares de instรขncias. Windows Projetos de formulรกrios.

O valor padrรฃo de MaxLength รฉ 32,767 caracteres, correspondendo ao limite de Int16.MaxValue. Defina a propriedade para qualquer nรบmero positivo menor para limitar a entrada ou defina-a como 0 para permitir o mรกximo suportado pelo controle.

Defina Multiline como True e WordWrap como True. O WordWrap รฉ ativado por padrรฃo quando Multiline รฉ habilitado, portanto, linhas longas sรฃo quebradas nos limites das palavras em vez de rolar horizontalmente. Adicione ScrollBars = Vertical se o texto puder crescer alรฉm da รกrea visรญvel.

O evento TextChanged รฉ disparado apรณs a propriedade Text ser alterada por qualquer motivo, incluindo colagem ou atualizaรงรตes programรกticas. O evento KeyPress รฉ disparado uma vez para cada tecla de caractere enquanto digita.ping, antes que a alteraรงรฃo chegue ao buffer, razรฃo pela qual รฉ usado para bloquear caracteres invรกlidos.

Um texto padrรฃoBox Aplica uma รบnica fonte e cor de primeiro plano a todo o controle. Para fragmentos coloridos, fontes mistas ou imagens incorporadas, troque por uma Texto ricoBox, que expรตe SelectionColor e SelectionFont no intervalo atualmente selecionado.

Resuma esta postagem com: