System.Web.UI.WebControls Namespace   Repeater Class

---

Specifies the template to use for each item in a Repeater.

<asp:repeater ... >

   <itemtemplate>
      ... template definition here
   </itemtemplate>

</asp:repeater>

An ITemplate interface that defines how the individual items in the Repeater control are rendered.

The property is read/write with no default value.

The ItemTemplate describes the layout of elements that are rendered once for each row in the data source.

To specify a template for the items of a Repeater, place an <ItemTemplate> element between the opening and closing tags of the control. You can then list the contents of the template between the opening and closing <ItemTemplate> ... </ItemTemplate> tags.

Items in the ItemTemplate are data-bound. To display data in the ItemTemplate, declare one or more Web server controls and set their data-binding expressions to evaluate to a field in the Repeater control's DataSource.

First Name: <asp:Label runat = "server"
   Text = "<%# Eval ( "FirstName" ) %>" />

For more information, see DataBinding Expression Syntax.

The Repeater allows to split HTML tags across its templates. For example, to render content bound to a single-field data source into a bulleted or ordered list, include

• the opening <ul> or <ol> tag in the HeaderTemplate,
• a single list item <li> element in the ItemTemplate, and
• the closing </ul> or </ol> tag in the FooterTemplate.

To render content bound to a multiple-field data source into a table using templates, include

• the opening <table> tag in the HeaderTemplate,
• a single table row <tr> element in the ItemTemplate, and
• the closing </table> tag in the FooterTemplate.

The following example illustrates using the ItemTemplate to display the items of a Repeater into an HTML table element.

<asp:repeater id = "myRepeater" runat = "server">

   <headertemplate>
      <table width=90% cellpadding=5>
      <tr style = "background-color:#ddc">
         <th>Product</th>
         <th>Price</th></tr>
   </headertemplate>

   <itemtemplate>
      <tr>
         <td><%# Eval ( "ProductID" ) %></td>
         <td align = "right"><%# Eval ( 
            "UnitPrice", "{0:c}" ) %></td></tr>
   </itemtemplate>

   <footertemplate>
      </table>
   </footertemplate>

</asp:repeater>

 Show me 

Repeater Members   AlternatingItemTemplate   HeaderTemplate   FooterTemplate   SeparatorTemplate

Books and more ...

Custom Search

Suggested Reading

Need a break ?