TextBox (Clase)
Ensamblado: System.Web (en system.web.dll)
[ControlValuePropertyAttribute("Text")] [ValidationPropertyAttribute("Text")] public class TextBox : WebControl, IPostBackDataHandler, IEditableTextControl, ITextControl
/** @attribute ControlValuePropertyAttribute("Text") */
/** @attribute ValidationPropertyAttribute("Text") */
public class TextBox extends WebControl implements IPostBackDataHandler, IEditableTextControl,
ITextControl
ControlValuePropertyAttribute("Text") ValidationPropertyAttribute("Text") public class TextBox extends WebControl implements IPostBackDataHandler, IEditableTextControl, ITextControl
El control de servidor TextBox es un control de entrada que permite al usuario escribir texto. De manera predeterminada, se establece la propiedad TextMode del control en TextBoxMode.SingleLine, que muestra un cuadro de texto de una sola línea. No obstante, también puede usar el control TextBox para mostrar un cuadro de texto multilínea o un cuadro de texto que enmascara los datos proporcionados por el usuario al cambiar el valor de la propiedad TextMode a TextBoxMode.MultiLine o TextBoxMode.Password, respectivamente. El texto mostrado en el control TextBox se especifica o determina con la propiedad Text.
El control TextBox contiene varias propiedades que permiten controlar la apariencia del control. El ancho de presentación del cuadro de texto, expresado en caracteres, viene determinado por la propiedad Columns. Si el control TextBox es un cuadro de texto multilínea, el número de filas que muestra lo determina la propiedad Rows. Para mostrar texto que se ajusta dentro del control TextBox, establezca la propiedad Wrap en true.
También se puede especificar cómo se incluyen los datos en el control TextBox estableciendo algunas propiedades. Para impedir que se modifique el texto mostrado en el control, establezca la propiedad ReadOnly en true. Para limitar los datos proporcionados por el usuario a un número especificado de caracteres, establezca la propiedad MaxLength.
Para obtener una lista con los valores de propiedad iniciales de una instancia de TextBox, vea el constructor TextBox.
 Precaución: |
|---|
| Este control se puede utilizar para aceptar los datos especificados por el usuario, que pueden incluir secuencias de comandos de cliente malintencionadas. Compruebe toda la información que se envíe desde un cliente antes de mostrarla en su aplicación para ver si hay secuencias de comandos ejecutables, instrucciones SQL o cualquier otro tipo de código. Puede utilizar controles de validación para comprobar los datos especificados por el usuario antes de mostrar el texto de entrada en un control. ASP.NET proporciona una característica de validación de solicitudes de entrada para bloquear secuencias de comandos y código HTML en los datos especificados usuario. Para obtener más información, vea Seguridad de controles estándar, Cómo: Proteger una aplicación Web frente a ataques mediante secuencias de comandos aplicando codificación HTML a las cadenas y Validar la información especificada por el usuario en páginas Web ASP.NET. |
Accesibilidad
Es posible que el marcado que se representa de manera predeterminada para este control no respete los estándares de accesibilidad enunciados en las directrices prioritarias de WCAG (Instrucciones de accesibilidad a contenido Web 1.0). Para obtener detalles sobre accesibilidad compatible con este control, vea Controles y accesibilidad en ASP.NET.
En el siguiente ejemplo de código se muestra cómo utilizar el control TextBox para obtener los datos proporcionados por el usuario. Cuando el usuario hace clic en el botón Agregar, se muestra la suma de los valores incluidos en los cuadros de texto.
| Nota: de seguridad |
|---|
| Este ejemplo tiene un cuadro de texto que acepta datos del usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, las páginas Web ASP.NET validan que los datos proporcionados por el usuario no incluyen elementos HTML ni de secuencia de comandos. Para obtener más información, vea Información general sobre los ataques mediante secuencias de comandos. |
<%@ Page Language="C#" AutoEventWireup="True" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" > <head> <title> TextBox Example </title> <script runat="server"> protected void AddButton_Click(Object sender, EventArgs e) { int Answer; Answer = Convert.ToInt32(Value1.Text) + Convert.ToInt32(Value2.Text); AnswerMessage.Text = Answer.ToString(); } </script> </head> <body> <form id="form1" runat="server"> <h3> TextBox Example </h3> <table> <tr> <td colspan="5"> Enter integer values into the text boxes. <br /> Click the Add button to add the two values. <br /> Click the Reset button to reset the text boxes. </td> </tr> <tr> <td colspan="5"> </td> </tr> <tr align="center"> <td> <asp:TextBox ID="Value1" Columns="2" MaxLength="3" Text="1" runat="server"/> </td> <td> + </td> <td> <asp:TextBox ID="Value2" Columns="2" MaxLength="3" Text="1" runat="server"/> </td> <td> = </td> <td> <asp:Label ID="AnswerMessage" runat="server"/> </td> </tr> <tr> <td colspan="2"> <asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Value1" ErrorMessage="Please enter a value.<br />" Display="Dynamic" runat="server"/> <asp:RangeValidator ID="Value1RangeValidator" ControlToValidate="Value1" Type="Integer" MinimumValue="1" MaximumValue="100" ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />" Display="Dynamic" runat="server"/> </td> <td colspan="2"> <asp:RequiredFieldValidator ID="Value2RequiredValidator" ControlToValidate="Value2" ErrorMessage="Please enter a value.<br />" Display="Dynamic" runat="server"/> <asp:RangeValidator ID="Value2RangeValidator" ControlToValidate="Value2" Type="Integer" MinimumValue="1" MaximumValue="100" ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />" Display="Dynamic" runat="server"/> </td> <td>   </td> </tr> <tr align="center"> <td colspan="4"> <asp:Button ID="AddButton" Text="Add" OnClick="AddButton_Click" runat="server"/> </td> <td> </td> </tr> </table> </form> </body> </html>
- AspNetHostingPermission para trabajar en un entorno alojado en host. Valor de la petición: LinkDemand; valor del permiso: Minimal
- AspNetHostingPermission para trabajar en un entorno alojado en host. Valor de la petición: InheritanceDemand; valor del permiso: Minimal
System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.TextBox
Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter
Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.