Repeater.HeaderTemplate Property
Gets or sets the System.Web.UI.ITemplate that defines how the header section of the Repeater control is displayed.
[Visual Basic] Public Overridable Property HeaderTemplate As ITemplate [C#] public virtual ITemplate HeaderTemplate {get; set;} [C++] public: __property virtual ITemplate* get_HeaderTemplate(); public: __property virtual void set_HeaderTemplate(ITemplate*); [JScript] public function get HeaderTemplate() : ITemplate; public function set HeaderTemplate(ITemplate);
Property Value
A System.Web.UI.ITemplate that defines how the header section of the Repeater control is displayed. The default value is a null reference (Nothing in Visual Basic).
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 Controls.
Example
[Visual Basic, C#] 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>).
[Visual Basic] <%@ Page Language="VB" AutoEventWireup="True" %> <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>Repeater Example</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> [C#] <%@ Page Language="C#" AutoEventWireup="True" %> <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>Repeater Example</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>
[C++, JScript] No example is available for C++ or JScript. To view a Visual Basic or C# example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family
See Also
Repeater Class | Repeater Members | System.Web.UI.WebControls Namespace | FooterTemplate | ItemTemplate | AlternatingItemTemplate | SeparatorTemplate