Como: Adicionar controles de servidor a uma página da Web ASP.NET usando sintaxe ASP.NET

Você pode adicionar um controle de servidor da Web a uma página, declarando-o diretamente no arquivo.aspx.

Observação:
Para obter informações básicas sobre os controles para páginas da Web ASP.NET, consulte Visão geral sobre controles do servidor da Web do ASP.NET

Para adicionar um controle declarativamente

1. Se estiver em um criador visual, alterne para o modo de edição de código-fonte.

2. Digite o elemento que representa o controle no arquivo .aspx.A sintaxe exata que você usa depende do controle que estiver adicionando, mas, em geral, a sintaxe a seguir se aplica:

   • Controles devem incluir o atributo .

   • Defina o atributo ID do controle, a menos que o controle seja parte de um controle complexo e será repetido (como nos controles GridView, FormView, DetailsView, Repeater, ou DataList).

   • Os controles de servidor Web são declarados com uma tag XML que faz referência ao namespace asp.

   • Declarações de controles devem estar fechadas corretamente.Você pode especificar uma marca de fechamento explícita, ou, se o controle não tiver nenhum elemento filho, você pode especificar uma marca de fechamento automático.As únicas exceções são controles de entrada HTML que não podem ter elementos filho, como os controles de entrada (por exemplo, HtmlInputText Servidor Controlar Declarative Syntax, HtmlButton Servidor Controlar Declarative Syntax e HtmlImage Servidor Controlar Declarative Syntax).

   • Propriedades do controle são declarados como atributos.

     Os exemplos a seguir mostram declarações típicas para os 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 obter informações sobre a sintaxe declarativa para um controle de servidor Web específico, consulte Servidor Web Controlarar sintaxe.

     Observação:
     Se o criador de página não pode mostrar um controle de servidor da Web corretamente, ele exibe uma caixa cinza com o texto " Error Creating Control. Isso geralmente significa que a sintaxe ASP.NET do controle está incorreta — por exemplo, se o atributo estiver ausente em um elemento de controle de servidor Web, você verá este erro.

Consulte também

Tarefas

Como: conjunto propriedades de estilo de controle de servidor ASP.NET por programação

Como: conjunto propriedades de estilo de controle de servidor ASP.NET usando sintaxe do ASP.NET

Como: conjunto propriedades de controle de servidor HTML programaticamente

Conceitos

Visão geral sobre controles do servidor da Web do ASP.NET