Información general sobre TextBox (Control de servidor Web)

Actualización: noviembre 2007

El control de servidor Web TextBox proporciona a los usuarios un medio para escribir datos en una página Web ASP.NET, incluidos texto, números y fechas.

Este tema contiene:

Background
Ejemplos de código
Referencia de clase

Background

El control de servidor TextBox es un control de entrada que permite al usuario escribir texto. De forma predeterminada, la propiedad TextMode del control se establece en TextBoxMode.SingleLine, que muestra un cuadro de texto de una sola línea. Sin embargo, puede establecer la propiedad TextMode en TextBoxMode.MultiLine para mostrar un cuadro de texto de varias líneas (que se representa como un elemento textarea ). También puede cambiar la propiedad TextMode a TextBoxMode.Password para mostrar un cuadro de texto que enmascara los datos proporcionados por el usuario. El texto mostrado en el control TextBox está disponible mediante el uso de la propiedad Text.

Nota de seguridad:
Establecer la propiedad TextMode en TextBoxMode.Password puede servir para asegurarse de que otras personas no pueden ver una contraseña mientras se escribe. Sin embargo, el texto escrito en el cuadro de texto no está cifrado de ningún modo y debería protegerlo igual que haría con otros datos confidenciales. Por ejemplo, para aumentar la seguridad al exponer una página que incluye una contraseña, puede utilizar la Capa de sockets seguros (SSL) y cifrado.

Establecer la propiedad TextMode en TextBoxMode.Password puede servir para asegurarse de que otras personas no pueden ver una contraseña mientras se escribe. Sin embargo, el texto escrito en el cuadro de texto no está cifrado de ningún modo y debería protegerlo igual que haría con otros datos confidenciales. Por ejemplo, para aumentar la seguridad al exponer una página que incluye una contraseña, puede utilizar la Capa de sockets seguros (SSL) y cifrado.

Nota de seguridad:
Los datos proporcionados por el usuario en una página web ASP.NET pueden incluir script de cliente malintencionado. De forma predeterminada, la página web ASP.NET valida que los datos proporcionados por el usuario no incluyen script ni elementos HTML. Para obtener más información, vea Información general sobre los ataques mediante secuencias de comandos.

Eventos de TextBox

El control TextBox desencadena un evento TextChanged cuando el usuario abandona el control. De forma predeterminada, el evento no se produce inmediatamente, sino que se produce en el servidor cuando se envía la página. Sin embargo, es posible especificar que el control TextBox envíe la página al servidor tan pronto como el usuario abandone el campo.

El control TextBox de servidor Web no desencadena un evento cada vez que el usuario presiona una tecla; sólo lo hace cuando el usuario abandona el control. Puede hacer que los eventos del cliente desencadenados por el control TextBox se controlen desde un script del cliente, lo que puede resultar ser útil para responder a las pulsaciones de las distintas teclas. Para obtener información detallada, vea Script de cliente en páginas web ASP.NET.

Títulos de TextBox

Puede utilizar los controles Label para crear títulos para los controles TextBox. El título puede definir una tecla de acceso que los usuarios pueden presionar para navegar hasta el control TextBox. Para obtener información detallada, vea Cómo: Utilizar controles Label de servidor Web como títulos.

Llenado automático en cuadros de texto

Muchos exploradores admiten una característica de llenado automático que ayuda los usuarios a rellenar la información en los cuadros de texto en función de los valores que los usuarios han especificado previamente. El comportamiento exacto de esta característica depende del explorador. En general, los exploradores almacenan valores de acuerdo con el atributo name del cuadro de texto; cualquier cuadro de texto con el mismo nombre, aunque se encuentre en una página diferente, ofrecerá los mismos valores al usuario. Algunos exploradores también admiten un esquema vCard que permite a los usuarios crear un perfil en el explorador con valores predefinidos para el nombre, el apellido, el número de teléfono, la dirección de correo electrónico, etc.

El control TextBox admite una propiedad AutoCompleteType que proporciona estas opciones para controlar el modo en que el explorador trabaja con el llenado automático:

Deshabilita el llenado automático. Si no desea que el explorador proporcione el llenado automático de un cuadro de texto, puede deshabilitarlo.
Especifique un valor vCard para utilizarlo como valor de llenado automático en el campo. El explorador debe admitir el esquema vCard.