Compartilhar via


Controle de servidor embutido modelo sintaxe

Especifica o conteúdo que será incluído, e como ele irá ser organizado e com estilo nos controles do servidor ASP.NET que oferecem suporte a modelos.

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

Rótulos de marcação

  • templatename
    O nome do modelo de controle de servidor ASP.NET.

Comentários

Modelos podem ser usados para estruturar e o conteúdo que aparece nos controles de servidor do ASP.NET de estilo. embutido sintaxe do modelo é uma forma útil para trabalhar com modelos, pois permite que você projete a organização e o estilo do conteúdo em um controle na sintaxe declarativa simples, em vez de fazê-lo por meio de programação.

Muitos controles do servidor Web do ASP.NET suportam modelos (por exemplo, a Repeater, DataList, GridView, FormView, MultiView, LoginView, e Menu controla todos sistema autônomo modelos de suporte, sistema autônomo controles de zona de 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 sistema autônomo elementos filhos dos controles de servidor que oferece 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, a Repeater controle oferece suporte a modelos para especificar o layout e aparência do conteúdo dentro de uma seção de cabeçalho, corpo de uma ou seção do item e uma seção de rodapé, bem sistema autônomo modelos especiais para lidar com sistema autônomo estilos de itens e separadores entre itens alternados. 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 nas Rótulos de modelo. Marcação adicional pode consistir em Rótulos HTML, controles ASP.NET e expressões de servidor embutido ou blocos de código. Para obter mais informações sobre como usar embutido modelos, consulte Modelos de controles servidores web 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 de usuário do ASP.NET modelado.

Exemplo

O exemplo de código a seguir mostra como declarar o HeaderTemplate, AlternatingItemTemplate, ItemTemplate, e FooterTemplate modelos em um Repeater Controle de servidor Web. Cada um desses modelos é associada a uma propriedade do 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 de usuário do ASP.NET modelado

Conceitos

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

Referência

Sintaxe de controle de servidor personalizado