Compartir a través de


Sintaxis declarativa del control de servidor Web TextBox

Actualización: noviembre 2007

Crea cuadros de texto de una y varias líneas.

<asp:TextBox
    AccessKey="string"
    AutoCompleteType="None|Disabled|Cellular|Company|Department|
        DisplayName|Email|FirstName|Gender|HomeCity|HomeCountryRegion|
        HomeFax|HomePhone|HomeState|HomeStreetAddress|HomeZipCode|
        Homepage|JobTitle|LastName|MiddleName|Notes|Office|Pager|
        BusinessCity|BusinessCountryRegion|BusinessFax|BusinessPhone|
        BusinessState|BusinessStreetAddress|BusinessUrl|
        BusinessZipCode|Search"
    AutoPostBack="True|False"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CausesValidation="True|False"
    Columns="integer"
    CssClass="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    MaxLength="integer"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnTextChanged="TextChanged event handler"
    OnUnload="Unload event handler"
    ReadOnly="True|False"
    Rows="integer"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Text="string"
    TextMode="SingleLine|MultiLine|Password"
    ToolTip="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
    Wrap="True|False"
/>

Comentarios

El control de servidor TextBox es un control de entrada que permite al usuario escribir texto. De manera predeterminada, el valor de la propiedad TextMode se establece en SingleLine, de modo que se crea un cuadro de texto con una sola línea. El valor de la propiedad también puede establecerse en MultiLine o Password. MultiLine crea un cuadro de texto con varias líneas. Password crea un cuadro de texto de una sola línea que oculte el valor especificado por el usuario.

El ancho del cuadro de texto viene determinado por su propiedad Columns. Si se trata de un cuadro de texto de varias líneas, su alto lo determina la propiedad Rows.

Utilice la propiedad Text para determinar el contenido del control TextBox. Para limitar el número de caracteres que se pueden escribir en el control, establezca el valor de la propiedad MaxLength. Establezca el valor de la propiedad Wrap en true para especificar que el contenido de la celda debe continuar automáticamente en la siguiente línea cuando alcanza el final del cuadro de texto.

Para obtener más información acerca de los eventos y propiedades del control de servidor Web TextBox, vea la documentación referente a la clase TextBox.

Ejemplo

A continuación se muestra un ejemplo de declaración de un control TextBox en un archivo .aspx. El control es un cuadro de texto de varias líneas que muestra un máximo de diez líneas. El texto tiene el formato de fuente Arial si el explorador admite fuentes para los controles.

fhc2c904.alert_security(es-es,VS.90).gifNota de seguridad:

En este ejemplo hay 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 los datos escritos por el usuario para comprobar que no incluyen secuencias de comandos ni elementos HTML. Para obtener más información, vea Información general sobre los ataques mediante secuencias de comandos.

<asp:TextBox id="txtLogin" runat="server"
     Text="" Font-Names="Arial" 
     Font-Size="10"
     BackColor="lightblue"
     TextMode="MultiLine"
     Height="43px"
/>
<asp:TextBox id="txtLogin" runat="server"
     Text="" Font-Names="Arial" 
     Font-Size="10"
     BackColor="lightblue"
     TextMode="MultiLine"
     Height="43px"
 />

Vea también

Referencia

TextBox

Otros recursos

Sintaxis de los controles de servidor Web