Поделиться через


Синтаксис встроенного шаблона серверных элементов управления

Указывает, какое содержимое необходимо включить в поддерживающие шаблоны серверные элементы управления ASP.NET, а также его расположение и стиль.

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

Теги разметки

  • templatename
    Имя шаблона серверного элемента управления ASP.NET.

Заметки

Для создания структуры и стиля содержимого, которое отображается в серверных элементах управления ASP.NET, можно использовать шаблоны. Синтаксис встроенного шаблона — это удобный способ работы с шаблонами, поскольку он позволяет создавать структуру и стиль содержимого элемента управления с помощью простого декларативного синтаксиса, а не программными средствами.

Многие элементы веб-сервера ASP.NET поддерживают шаблоны (например, Repeater, DataList, GridView, FormView, MultiView, LoginView и все элементы управления Menu поддерживают шаблоны, а также элементы управления зоны веб-частей, включающие WebPartZone и CatalogZone). Обратите внимание, что только те шаблоны, которые специально определены для элемента управления, можно объявлять для этого элемента управления.

Элементы шаблона должны объявляться как дочерние элементы серверных элементов управления, которые их поддерживают. Серверный элемент управления может содержать несколько элементов шаблона, причем каждый шаблон используется для указания характеристик различных элементов содержимого элемента управления. Например элемент управления Repeater поддерживает шаблоны, определяющие разметку и внешний вид элемента управления в разделе заголовка, теле или разделе элемента, а также в разделе нижнего колонтитула. Кроме того, он поддерживает специальные шаблоны позволяющие обрабатывать стили чередующихся элементов и их разделителей. Дополнительные сведения см. в примере кода в этом в разделе.

Для задания способа отображения содержимого в шаблоне необходимо объявить дополнительные элементы в тегах шаблона. Дополнительная разметка может содержать: теги HTML, элементы управления ASP.NET и встроенные выражения на стороне сервера или блоки кода. Дополнительные сведения об использовании встроенных шаблонов см. в разделе Шаблоны серверных веб-элементов управления ASP.NET.

Кроме того, при разработке специализированных серверных элементов управления можно определить пользовательские шаблоны. Дополнительные сведения о разработке элементов управления, которые определяют и используют встроенные шаблоны стиля см. в разделе Практическое руководство. Создание пользовательских элементов управления-шаблонов ASP.NET.

Пример

В следующем примере кода показано, как объявлять шаблоны HeaderTemplate, AlternatingItemTemplate, ItemTemplate и FooterTemplate в элементе управления веб-сервером Repeater . Каждый из этих шаблонов связан со свойством класса Repeater .

<%@ 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>    

См. также

Задачи

Практическое руководство. Создание пользовательских элементов управления-шаблонов ASP.NET

Ссылки

Синтаксис настраиваемых серверных элементов управления

Основные понятия

Общие сведения о синтаксисе веб-страниц ASP.NET