Export (0) Print
Expand All

Repeater.HeaderTemplate Property

Gets or sets the System.Web.UI.ITemplate that defines how the header section of the Repeater control is displayed.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

[TemplateContainerAttribute(typeof(RepeaterItem))]
[BrowsableAttribute(false)]
[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
public virtual ITemplate HeaderTemplate { get; set; }
<asp:Repeater>
	<HeaderTemplate>ITemplate</HeaderTemplate>
</asp:Repeater>

Property Value

Type: System.Web.UI.ITemplate
A System.Web.UI.ITemplate that defines how the header section of the Repeater control is displayed. The default value is null.

Use this property to create a template that controls how the header section of a Repeater control is displayed.

Caution noteCaution

This control can be used to display user input, which might include malicious client script. Check any information that is sent from a client for executable script, SQL statements, or other code before displaying it in your application. ASP.NET provides an input request validation feature to block script and HTML in user input. Validation server controls are also provided to assess user input. For more information, see Validation Server Control Syntax.

The following example demonstrates how to use the HeaderTemplate to control the appearance of the header for the Repeater control. Notice that the HeaderTemplate contains the table's start tag (<table>).


<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
 <head>
    <title>Repeater Example</title>
<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>Repeater Example</h3>

    <form id="form1" runat="server">

       <b>Repeater1:</b>
       <br />

       <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>
       <br />

    </form>
 </body>
 </html>
    


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Community Additions

ADD
Show:
© 2014 Microsoft