Tutorial del control TEXTBOX de VB.Net: propiedades con ejemplo

โšก Resumen inteligente

TextoBox Los controles en VB.Net aceptan la entrada del usuario en un Windows Cree y exponga propiedades como Multiline, PasswordChar, MaxLength y ReadOnly para controlar cรณmo se introduce, oculta, limita o bloquea el texto en tiempo de ejecuciรณn.

  • ๐Ÿงฉ Propรณsito principal: El textoBox El control captura la entrada del usuario de una o varias lรญneas en un Windows Formulario durante la ejecuciรณn.
  • ๐Ÿ”ค Propiedades clave: TextAlign, ScrollBars, Multiline, MaxLength, Readonly y PasswordChar personalizan el comportamiento del control.
  • ๐Ÿ” Enmascaramiento de contraseรฑas: Configurar PasswordChar en * oculta los caracteres a medida que el usuario escribe, keeping Informaciรณn confidencial privada.
  • ๐Ÿ“„ Varias lรญneas: Establezca Multiline en True y, a continuaciรณn, utilice ControlChars.NewLine para dividir el texto en filas separadas.
  • ๐Ÿ”ข Valores numรฉricos: Convierta la cadena con Integer.Parse antes de procesar cualquier texto.Box entrada como nรบmero.
  • ๐Ÿค– Asistencia de IA: GitHub Copilot y Visual Studio 2026 IntelliCode Puede generar controladores de eventos y validar la entrada de datos tipificada.

Texto VB.NetBox Propiedades y ejemplos de control

ยฟQuรฉ es el texto?Box ยฟControlar?

El textoBox El control le permite ingresar texto en su formulario durante el tiempo de ejecuciรณn. La configuraciรณn predeterminada es que aceptarรก solo una lรญnea de texto, pero puede modificarla para aceptar varias lรญneas. Incluso puedes incluir barras de desplazamiento en tu texto.Box Control:

TextoBox Propiedades

Las siguientes son las propiedades mรกs comunes del texto de Visual Basic.Box Control:

  • TextAlignโ€“ para configurar la alineaciรณn del texto
  • ScrollBarsโ€“ para agregar barras de desplazamiento, tanto verticales como horizontales
  • Multilineโ€“ para configurar el textoBox Control para permitir mรบltiples lรญneas.
  • MaxLengthโ€“ para especificar el nรบmero mรกximo de caracteres del TextoBox El control aceptarรก
  • Homeโ€“ para especificar el รญndice de la matriz de control
  • Los usuarios de la app Smart Spaces con Google Wallet disfrutan de acceso mรณvil sin contacto con cualquier lector HIDยฎ Signoโ„ข con NFC.โ€“ para habilitar el control del cuadro de texto
  • Solo lecturaโ€“ si se establece en verdadero, podrรก utilizar el textoBox Control, si se establece en falso, no podrรก utilizar el texto.Box Control:
  • SelecciรณnInicioโ€“ para establecer u obtener el punto de partida del TextoBox Control:
  • SelecciรณnLongitudโ€“ para configurar u obtener el nรบmero de caracteres que se han seleccionado en el TextoBox Control:
  • Texto seleccionadoโ€“ devuelve el textoBox Control que estรก actualmente seleccionado.

TextoBox Eventos

El propรณsito de los eventos es hacer que el TextoBox El control responde a acciones del usuario, como un clic, un doble clic o un cambio en la alineaciรณn del texto. Estos son los eventos comunes para el textoBox Controlar:

  • Tamaรฑo automรกtico cambiadoโ€“ Activado por un cambio en la propiedad AutoSize.
  • Sรณlo lecturaCambiadoโ€“ Activado por un cambio en el valor de la propiedad ReadOnly.
  • Haga clic en โ€“ Activado por un clic en el TextoBox Control:

Cรณmo crear un textoBox

Sigue estos pasos para aรฑadir tu primer texto.Box control a un Windows Generar y mostrar un mensaje de saludo en tiempo de ejecuciรณn.

Paso 1) Para crear un textoBox, arrastra el TextoBox control desde la caja de herramientas hacia el Windows Formar:

TextoBox control aรฑadido al Windows Superficie de diseรฑo de forma

Paso 2)

  1. Haga clic en el textoBox Control que has aรฑadido al formulario.
  2. Vaya a la secciรณn Propiedades ubicada en la parte inferior izquierda de la pantalla. Cambie el nombre del cuadro de texto de TextoBox1 a HolaTextoBox:

Cambiar el nombre del textoBox a HelloTextBox en la ventana Propiedades

Paso 3) Agregue el siguiente cรณdigo para aรฑadir texto al control:

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

Paso 4) Ahora puede ejecutar el cรณdigo haciendo clic en el botรณn Iniciar ubicado en la barra superior:

El botรณn de inicio en la barra de herramientas de Visual Studio se utiliza para ejecutar el proyecto.

Paso 5) Deberรญas obtener el siguiente formulario:

Ejecutando el formulario que muestra Hola. Bienvenido a Guruยก99! en el textoBox

Aquรญ hay una captura de pantalla del cรณdigo completo de lo anterior:

Complete el cรณdigo Form1_Load que establece HelloTextBox envรญenos mensaje de texto

Explicaciรณn del cรณdigo:

  1. Creando una clase pรบblica llamada Form1.
  2. Creando un subprocedimiento llamado Form1_Load. Se llamarรก cuando se cargue el formulario.
  3. Un comentario. El compilador de VB.Net lo omitirรก.
  4. Finalice el subprocedimiento.
  5. Termina la clase.

Propiedad PasswordChar

A veces, querrรกs que un cuadro de texto se utilice para...ping una contraseรฑa. Esto significa que todo lo que se escriba en ese cuadro de texto debe permanecer confidencial. Esto es posible con VB.Net. Se puede hacer usando el Passwordchar propiedad que nos permite utilizar cualquier carรกcter que queramos. Demostremos esto usando un ejemplo:

Comience creando un nuevo proyecto. Arrastra dos textoBox Controles, dos etiquetas y un botรณn en el formulario. Cambie los textos de las dos etiquetas y del botรณn por los siguientes:

Diseรฑo de formulario de inicio de sesiรณn con etiquetas de nombre de usuario, contraseรฑa y texto.Box controles y botรณn de inicio de sesiรณn

Haga clic en el cuadro de texto junto a la etiqueta Nombre de usuario, vaya a la secciรณn Propiedades ubicada en la parte inferior izquierda de la ventana y asรญgnele el nombre Campo de nombre de usuario.

Establecer la propiedad Nombre del texto Nombre de usuarioBox al campo Nombre de usuario

Haz lo mismo con el texto.Box Controle junto a la etiqueta Contraseรฑa y asรญgnele el nombre CampoContraseรฑa.

Establecer la propiedad Nombre del texto de la contraseรฑaBox al campo de contraseรฑa

Ahora deberรญas crear el texto del campo de contraseรฑa.Box Controla mostrar * por cada caracter que se escriba en รฉl. Agrega el siguiente cรณdigo:

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

Ahora, ejecute el cรณdigo haciendo clic en el botรณn Inicio. Aparecerรก un formulario.

Escribe el nombre de usuario y la contraseรฑa y observa lo que sucede. Deberรญas ver lo siguiente:

Formulario de inicio de sesiรณn con el campo de contraseรฑa oculto entre asteriscos.

Se muestra el nombre de usuario, pero se ha ocultado la contraseรฑa. Aquรญ estรก el cรณdigo para lo anterior:

Cรณdigo completo del controlador de eventos PasswordChar en VB.Net para PasswordField_TextChanged

Explicaciรณn del cรณdigo:

  1. Creando una clase llamada Form1.
  2. Se crearรก un subprocedimiento llamado PasswordField_TextChanged(). Se llamarรก cuando se cargue el formulario.
  3. Usar la propiedad PasswordChar para mostrar * cuando un usuario escribe la contraseรฑa.
  4. Finalizando el subprocedimiento.
  5. Terminando la clase.

Nueva lรญnea en el textoBox

De forma predeterminada, solo se puede crear una lรญnea de texto en un cuadro de texto. Hay dos formas de lograrlo. Vamos a analizarlas.

Arrastra y suelta un textoBox Controla tu formulario. Dale al control el nombre GuruBienvenido.

TextoBox renombrado a GuruBienvenido mostrado en la superficie de diseรฑo del formulario

Haga clic nuevamente en el control del cuadro de texto y mueva el cursor del mouse a la secciรณn Propiedades. Cambie el valor de la propiedad Multiline a True.

La propiedad Multiline estรก configurada como Verdadero en la ventana Propiedades.

Alternativamente, puede establecer la propiedad Multiline en verdadero en su cรณdigo de la siguiente manera:

GuruBienvenido.Multiline = Verdadero

Agrega el siguiente 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

Tras la ejecuciรณn, las dos lรญneas de texto se separarรกn.

Formato en ejecuciรณn que muestra la Lรญnea 1 y la Lรญnea 2 separadas por un salto de lรญnea.

Explicaciรณn de Code:

  1. Creando una clase llamada Form1.
  2. Creando una subrutina llamada Form1_Load().
  3. Al establecer la propiedad Multiline en True, el cuadro de texto podrรก admitir mรกs de una lรญnea.
  4. Agregar la primera lรญnea de texto al cuadro de texto.
  5. Agregar la segunda lรญnea de texto al cuadro de texto. La propiedad ControlChars.NewLine nos ayuda a dividir las dos lรญneas.
  6. Finalizando la subrutina.
  7. Terminando la clase.

Recuperar valores enteros

VB.Net trata todo como una cadena de texto. Esto significa que se lee un nรบmero entero del cuadro de texto como una cadena y luego se convierte a un nรบmero entero. Normalmente, esto se hace utilizando el mรฉtodo Integer.Parse().

Para demostrarlo, cree un nuevo control de cuadro de texto mรกs un botรณn. Asรญgnele al cuadro de texto el nombre age. Asรญgnele al botรณn el nombre Button1. Deberรญa tener la siguiente interfaz:

TextoBox edad nombrada y un botรณn Mostrar edad colocado en el formulario

Agrega el siguiente 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)

Ejecute el cรณdigo e ingrese su edad en el cuadro de texto. Haga clic en el botรณn Mostrar edad. Deberรญa ver lo siguiente:

Mostrar cuadro de diรกlogo de edad que muestra el valor entero introducido en un mensaje.Box

El valor que ingresa se devuelve en un mensajeBox.

Cรณdigo completo de Button1_Click que analiza el texto de la edad.Box valor a un nรบmero entero

Explicaciรณn de Code:

  1. Creando una clase llamada Form1.
  2. Creando un subprocedimiento llamado Button1_Click. Se llamarรก cuando se haga clic en el botรณn.
  3. Definiendo una variable entera llamada x.
  4. Conversiรณn del valor leรญdo del cuadro de texto llamado edad en un entero.
  5. Mostrar el valor convertido en el paso anterior en un mensajeBox.
  6. Finalizando el subprocedimiento.

Texto de sรณlo lecturaBox

Puedes hacer que un cuadro de texto sea de solo lectura. Esto significa que el usuario no podrรก modificar el valor que se muestra en รฉl. Para ello, establece la propiedad ReadOnly en True. Para demostrarlo, crea un nuevo cuadro de texto y asรญgnale el nombre guru99. Aรฑade el siguiente 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

El cรณdigo deberรญa devolver lo siguiente:

Texto de sรณlo lecturaBox corriendo con texto bienvenido a Guru99 que no se pueden editar

Aquรญ estรก el cรณdigo:

Cรณdigo completo del controlador de eventos guru99_TextChanged que establece ReadOnly en True

Explicaciรณn de Code:

  1. Creando una clase llamada Form1.
  2. Creando una subrutina llamada guru99_TextChanged.
  3. Aรฑadiendo texto al cuadro de texto llamado guru99.
  4. Al establecer la propiedad ReadOnly del cuadro de texto en True, el texto que contiene no se puede modificar.
  5. Finalizando el subprocedimiento.
  6. Terminando la clase.

Propiedad de longitud mรกxima

La propiedad MaxLength puede ayudarle a establecer la cantidad mรกxima de palabras o caracteres que el cuadro de texto permitirรก. Para demostrar esto, cree un cuadro de textoBox Controla y asรญgnale el nombre fullName. Agrega el siguiente cรณdigo:

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

        fullName.MaxLength = 8

    End Sub

Ejecute el cรณdigo e intente escribir su nombre completo. No podrรก escribir mรกs de 8 caracteres, con espacios en blanco incluidos:

Texto de longitud mรกximaBox limitar la entrada a ocho caracteres en tiempo de ejecuciรณn

El cรณdigo:

Cรณdigo completo de fullName_TextChanged que establece MaxLength en 8

Code Explicaciรณn:

  1. Creando una clase llamada Form1.
  2. Creando un subprocedimiento llamado fullName_TextChanged.
  3. Hacer que el cuadro de texto fullName acepte un mรกximo de solo 8 caracteres.
  4. Finalizando el subprocedimiento.
  5. Terminando la clase.

Preguntas Frecuentes

A TextoBox Almacena texto plano con un lรญmite de 64K caracteres y un bajo consumo de recursos, ideal para la entrada de formularios. Texto ricoBox Admite fuentes, colores, imรกgenes y longitud ilimitada, por lo que resulta ideal para editores que necesitan contenido con estilo o de formato largo.

Maneje el evento KeyPress y establezca e.Handled = True cuando Char.IsDigit y Char.IsControl ambos devuelven False. Para una validaciรณn segura de pegado, utilice el evento Validating con Entero.IntentarPrueba y mostrar comentarios a travรฉs de un ErrorProvider.

Sรญ. Copiloto de GitHub Lee el cรณdigo del formulario circundante y sugiere controladores completos para TextChanged, KeyPress o Validating. RevRevisa el cรณdigo generado, agrega comprobaciones de valores nulos y ajusta los nombres antes de aceptarlo para que coincida con las convenciones de tu proyecto.

Visual Studio 2026 IntelliCode clasifica al probable prรณximo miembro en TextoBox instancias, autocompleta asignaciones de propiedades como Multiline o MaxLength, y sugiere ediciones de lรญnea completa basadas en patrones aprendidos de miles de Windows Formularios proyectos.

El valor predeterminado de MaxLength es de 32 767 caracteres, lo que coincide con el lรญmite de Int16.MaxValue. Establezca la propiedad en cualquier nรบmero positivo menor para limitar la entrada, o establรฉzcala en 0 para permitir el mรกximo que admite el control.

Establezca Multilรญnea en Verdadero y Ajuste de texto en Verdadero. El Ajuste de texto se activa por defecto al habilitar Multilรญnea, por lo que las lรญneas largas se dividen en los lรญmites de las palabras en lugar de desplazarse horizontalmente. Aรฑada Barras de desplazamiento = Vertical si el texto puede extenderse mรกs allรก del รกrea visible.

TextChanged se activa despuรฉs de que la propiedad Text cambie por cualquier motivo, incluyendo el pegado o las actualizaciones programรกticas. KeyPress se activa una vez por cada tecla de carรกcter mientras estรฉ pulsada.ping, antes de que el cambio llegue al bรบfer, razรณn por la cual se utiliza para bloquear caracteres no vรกlidos.

Un texto estรกndarBox Aplica una fuente y un color de primer plano a todo el control. Para fragmentos de color, fuentes mixtas o imรกgenes incrustadas, cรกmbielo por un Texto ricoBox, que expone SelectionColor y SelectionFont en el rango seleccionado actualmente.

Resumir este post con: