Partilhar via


Sintaxe de modelo de linha de controle de servidor

Especifica que o conteúdo será incluído e como ele será organizado e o estilo, no ASP.NET que oferecem suporte a modelos.

<templatename>
   Server control, data-binding syntax, other valid markup
</templatename>

Marcas de marcação

  • templatename
    O nome do aplicativo ASP.Modelo de controle de servidor de rede.

Comentários

Modelos podem ser usados para estruturar e estilo o conteúdo que aparece no ASP.NET internos. Sintaxe de modelo embutido é uma maneira útil para trabalhar com modelos, porque ela permite que você projete a organização e o estilo do conteúdo em um controle simple sintaxe declarativa, em vez de fazê-lo por meio de programação.

Muitos aplicativos ASP.Suporte para modelos de controles de servidor Web do NET (por exemplo, o Repeater, DataList, GridView, FormView, MultiView, LoginView, e Menu controla todos os modelos de suporte, como fazem os controles de zona Web Parts incluindo WebPartZone e CatalogZone). Observe que apenas os modelos são definidos especificamente para um controle, na verdade, podem ser declarados para o controle.

Itens de modelo devem ser declarados como elementos filho de controles de servidor que suporte a eles. Um controle de servidor pode conter vários itens de modelo, com cada modelo usado para especificar as características de um conteúdo diferente no controle. Por exemplo, o Repeater controle suporta modelos para especificar o layout e aparência do conteúdo dentro de uma seção de cabeçalho, um corpo ou seção do item e uma seção de rodapé, bem como modelos especiais para lidar com os estilos para alternados, itens e separadores entre itens. Para obter detalhes, consulte o exemplo de código neste tópico.

Para especificar como o conteúdo será exibido dentro de um modelo, você pode declarar elementos adicionais em tags de modelo. A marcação adicional pode consistir em tags HTML, ASP.NET personalizados e expressões do lado do servidor embutido ou blocos de código. Para obter mais informações sobre como usar modelos de in-line, consulte Modelos de controles de servidor Web do ASP.NET.

Quando você desenvolver controles de servidor personalizados, você pode definir seus próprios modelos. Para obter mais informações sobre como desenvolver controles que definem e usam modelos de estilo in-line, consulte Como: criar controles modelos de usuários do ASP.NET.

Exemplo

O exemplo de código a seguir mostra como declarar a HeaderTemplate, AlternatingItemTemplate, ItemTemplate, e FooterTemplate modelos em um Repeater controle de servidor Web. Cada um desses modelos é associado uma propriedade da Repeater classe.

<%@ Page Language="C#" %>
<html>
 <head>
    <script language="C#" runat="server">
       void Page_Load(Object Sender, EventArgs e) {
 
          if (!IsPostBack) {
             ArrayList values = new ArrayList();
 
             values.Add("Apple");
             values.Add("Orange");
             values.Add("Pear");
             values.Add("Banana");
             values.Add("Grape");
 
             Repeater1.DataSource = values;
             Repeater1.DataBind();
          }
       }
    </script>
 
 </head>
 <body>
 
    <h3><font face="Verdana">Repeater Example</font></h3>
 
    <form runat=server>
 
       <b>Repeater1:</b>
       <p>
         
       <asp:Repeater id=Repeater1 runat="server">
             
             
          <HeaderTemplate>
             <table border=1>
          </HeaderTemplate>
 
          <AlternatingItemTemplate>
             <tr>
                <td><b> <%# Container.DataItem %> </b> </td>
             </tr>
          </AlternatingItemTemplate>
 
          <ItemTemplate>
             <tr>
                <td> <%# Container.DataItem %> </td>
             </tr>
          </ItemTemplate>
 
          <FooterTemplate>
             </table>
          </FooterTemplate>
             
       </asp:Repeater>
       <p>
         
    </form>
 </body>
 </html>
<%@ Page Language="VB" %> 
<html>
<head>
<script language="VB" runat="server">

        Sub Page_Load(Sender As Object, e As EventArgs)
            
            If Not IsPostBack Then
                Dim values As New ArrayList()
                
                values.Add("Apple")
                values.Add("Orange")
                values.Add("Pear")
                values.Add("Banana")
                values.Add("Grape")
                
                Repeater1.DataSource = values
                Repeater1.DataBind()
            End If
        End Sub
</script>
 
 </head>
 <body>
 
    <h3><font face="Verdana">Repeater Example</font></h3>
 
    <form runat=server>
 
       <b>Repeater1:</b>
       <p>
         
       <asp:Repeater id=Repeater1 runat="server">
             
             
          <HeaderTemplate>
             <table border=1>
          </HeaderTemplate>
 
          <AlternatingItemTemplate>
             <tr>
                <td><b> <%# Container.DataItem %> </b> </td>
             </tr>
          </AlternatingItemTemplate>
 
          <ItemTemplate>
             <tr>
                <td> <%# Container.DataItem %> </td>
             </tr>
          </ItemTemplate>
 
          <FooterTemplate>
             </table>
          </FooterTemplate>
             
       </asp:Repeater>
       <p>
         
    </form>
 </body>
 </html>    

Consulte também

Tarefas

Como: criar controles modelos de usuários do ASP.NET

Referência

Personalizar Sintaxe de controle do servidor

Conceitos

Visão geral da sintaxe de página da Web ASP.NET