Cómo: Agregar controles de servidor a una página Web ASP.NET mediante la sintaxis de ASP.NET

Actualización: noviembre 2007

Se puede agregar un control de servidor Web a una página declarándolo directamente en el archivo .aspx.

Nota:
Para obtener información adicional sobre controles para páginas Web ASP.NET, vea Información general sobre los controles de servidor Web ASP.NET

Para agregar un control mediante declaración

1. Si está en un diseñador visual, cambie a la vista de edición de origen.

2. Escriba el elemento que representa el control en el archivo .aspx. La sintaxis exacta que debe utilizar depende del control que esté agregando, pero en general se aplican las siguientes reglas:

   • Los controles deben incluir el atributo .

   • Establezca el atributo ID del control a menos que el control forme parte de un control complejo y se repita (como en los controles GridView, FormView, DetailsView, Repeater o DataList).

   • Los controles de servidor Web se declaran con una etiqueta XML que hace referencia al espacio de nombres asp.

   • Las declaraciones del control deben cerrarse correctamente. Se puede especificar una etiqueta de cierre explícita o, en caso de que el control no tenga elementos secundarios, puede especificarse una etiqueta de cierre automático. Las únicas excepciones son los controles de entrada HTML que no pueden tener elementos secundarios, como los controles de entrada (por ejemplo, Sintaxis declarativa del control de servidor HtmlInputText, Sintaxis declarativa del control de servidor HtmlImage y Sintaxis declarativa del control de servidor HtmlButton).

   • Las propiedades del control se declaran como atributos.

     En los siguientes ejemplos se muestran declaraciones típicas para controles de servidor Web:

     <!-- Textbox Web server control -->
     <asp:textbox id="TextBox1" runat="Server" Text=""></asp:textbox>
     
     <!-- Same, but with self-closing element -->
     <asp:textbox id="Textbox2" runat="Server" Text="" />
     
     <!-- Web DropDownList control, which contains subelements -->
     <asp:DropDownList id="DropDown1" >
        <asp:ListItem Value="0">0</asp:ListItem>
        <asp:ListItem Value="1">1</asp:ListItem>
        <asp:ListItem Value="2">2</asp:ListItem>
        <asp:ListItem Value="3">3</asp:ListItem>
     </asp:DropDownList>
     
     <asp:Repeater id="Repeater2" >
        <HeaderTemplate>
            Company data:
        </HeaderTemplate>
        <ItemTemplate>
            <asp:Label ID="Label1"  
                  Font-Names="verdana" Font-Size="10pt"
                  Text='<%# Eval("Name") %>' />
            ( <asp:Label ID="Label2" 
                  Font-Names="verdana" Font-Size="10pt"
                  Text='<%# Eval("Ticker") %>'/>
             )
        </ItemTemplate>
        <SeparatorTemplate>
            ,
        </SeparatorTemplate>
     </asp:Repeater>
     

     <!-- Textbox Web server control -->
     <asp:textbox id="TextBox1" runat="Server" Text=""></asp:textbox>
     
     <!-- Same, but with self-closing element -->
     <asp:textbox id="Textbox2" runat="Server" Text="" />
     
     <!-- Web DropDownList control, which contains subelements -->
     <asp:DropDownList id="DropDown1" >
        <asp:ListItem Value="0">0</asp:ListItem>
        <asp:ListItem Value="1">1</asp:ListItem>
        <asp:ListItem Value="2">2</asp:ListItem>
        <asp:ListItem Value="3">3</asp:ListItem>
     </asp:DropDownList>
     
     <asp:Repeater id="Repeater2" >
        <HeaderTemplate>
            Company data:
        </HeaderTemplate>
        <ItemTemplate>
            <asp:Label ID="Label1"  
                  Font-Names="verdana" Font-Size="10pt"
                  Text='<%# Eval("Name") %>' />
            ( <asp:Label ID="Label2" 
                  Font-Names="verdana" Font-Size="10pt"
                  Text='<%# Eval("Ticker") %>'/>
             )
        </ItemTemplate>
        <SeparatorTemplate>
            ,
        </SeparatorTemplate>
     </asp:Repeater>
     

     Para obtener información sobre la sintaxis declarativa para un control de servidor Web concreto, vea Sintaxis de los controles de servidor Web.

     Nota:
     Si el diseñador de páginas no puede representar correctamente un control de servidor Web, muestra un cuadro gris con el texto "Error al crear el control". Esto normalmente significa que la sintaxis ASP.NET del control es incorrecta, por ejemplo, puede aparecer si falta el atributo en un elemento del control de servidor Web.

Vea también

Tareas

Cómo: Establecer propiedades de estilo de un control de servidor ASP.NET mediante programación

Cómo: Establecer propiedades de estilo de un control de servidor ASP.NET mediante sintaxis de ASP.NET

Cómo: Establecer las propiedades de un control de servidor HTML mediante programación

Conceptos

Información general sobre los controles de servidor Web ASP.NET