1 out of 1 rated this helpful - Rate this topic

Repeater.HeaderTemplate Property

.NET Framework 4

Other Versions

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)

Syntax

C++

Copy

[TemplateContainerAttribute(typeof(RepeaterItem))]
[BrowsableAttribute(false)]
[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
public virtual ITemplate HeaderTemplate { get; set; }

ASP.NET

Copy

<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.

Remarks

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

Caution
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.

Caution

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.

Examples

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>).

Copy


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

Version Information

.NET Framework

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

Platforms

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.

Reference

Repeater Class

System.Web.UI.WebControls Namespace

FooterTemplate

ItemTemplate

AlternatingItemTemplate

SeparatorTemplate

Other Resources

Repeater Web Server Control Overview

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ

Examples- none working.

Please, when you post an illustration regarding a subject can you have the decency to state whether it is a working example or not. Today alone I have tied to emulate 32 of your examples and NONE have worked. Many of your examples are not 'real-time' either. I have wasted too many months touring your pages in the hopes of learning and I have not learnt a thing due to non working 'examples', worthless examples, or just plain abstractions. To be honest it is beyond a joke. When you attempt to explain simple subjects such as this it stands to reason that the people consulting the article are 'beginners' therefore CARE ashould be taken with the illustration and all necessary details should be included. An expert will look at this and laugth be cause to them it is obvious that the code is worthless but to a beginner they do not have the benefit of that experience. Wake Microsoft and remember your roots.

History

5/21/2011
RayH166