Repeater.ItemTemplate Property
Gets or sets the System.Web.UI.ITemplate that defines how items in the Repeater control are displayed.
[Visual Basic] Public Overridable Property ItemTemplate As ITemplate [C#] public virtual ITemplate ItemTemplate {get; set;} [C++] public: __property virtual ITemplate* get_ItemTemplate(); public: __property virtual void set_ItemTemplate(ITemplate*); [JScript] public function get ItemTemplate() : ITemplate; public function set ItemTemplate(ITemplate);
Property Value
A System.Web.UI.ITemplate that defines how items in the Repeater control are displayed. The default value is a null reference (Nothing in Visual Basic).
Remarks
Use this property to create a template that controls how items in the Repeater control are 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 illustrates how to use a simple Repeater control to display a table of items. Notice the use of the ItemTemplate to display each item in the data source.
[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> <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> <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 | AlternatingItemTemplate | HeaderTemplate | FooterTemplate | SeparatorTemplate