Repeater.Items Property
Gets a collection of RepeaterItem objects in the Repeater.
[Visual Basic] Public Overridable ReadOnly Property Items As _ RepeaterItemCollection [C#] public virtual RepeaterItemCollection Items {get;} [C++] public: __property virtual RepeaterItemCollection* get_Items(); [JScript] public function get Items() : RepeaterItemCollection;
Property Value
A collection of RepeaterItem objects. The default is an empty RepeaterItemCollection.
Remarks
The Repeater populates the Items collection by enumerating every object in its DataSource. The Items collection is then used by the Repeater to render each item in the control.
Example
[Visual Basic, C#] The following example demonstrates how to use the Items property to determine the index of the item selected from the Repeater control.
[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(New PositionData("Microsoft", "Msft")) values.Add(New PositionData("Intel", "Intc")) values.Add(New PositionData("Dell", "Dell")) Repeater1.DataSource = values Repeater1.DataBind() End If End Sub Sub R1_ItemCommand(Sender As Object, e As RepeaterCommandEventArgs) Label2.Text = "Button " & _ Repeater1.Items(e.Item.ItemIndex).ItemIndex.ToString() & _ " has just been clicked! <br>" End Sub Public Class PositionData Private myName As String Private myTicker As String Public Sub New(newName As String, newTicker As String) Me.myName = newName Me.myTicker = newTicker End Sub Public ReadOnly Property Name() As String Get Return myName End Get End Property Public ReadOnly Property Ticker() As String Get Return myTicker End Get End Property End Class </script> </head> <body> <h3>Repeater Example</h3> <form runat=server> <b>Repeater1:</b> <p> <asp:Repeater id=Repeater1 OnItemCommand="R1_ItemCommand" runat="server"> <HeaderTemplate> <table border=1> <tr> <td><b>Company</b></td> <td><b>Symbol</b></td> </tr> </HeaderTemplate> <ItemTemplate> <tr> <td> <%# DataBinder.Eval(Container.DataItem, "Name") %> </td> <td> <asp:Button Text=<%# DataBinder.Eval(Container.DataItem, "Ticker") %> runat="server" /></td> </tr> </ItemTemplate> <FooterTemplate> </table> </FooterTemplate> </asp:Repeater> <p> <asp:Label id=Label2 font-name="Verdana" ForeColor="Green" font-size="10pt" runat="server"/> </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(new PositionData("Microsoft", "Msft")); values.Add(new PositionData("Intel", "Intc")); values.Add(new PositionData("Dell", "Dell")); Repeater1.DataSource = values; Repeater1.DataBind(); } } void R1_ItemCommand(Object Sender, RepeaterCommandEventArgs e) { Label2.Text = "Button " + Repeater1.Items[e.Item.ItemIndex].ItemIndex.ToString() + " has just been clicked! <br>"; } public class PositionData { private string name; private string ticker; public PositionData(string name, string ticker) { this.name = name; this.ticker = ticker; } public string Name { get { return name; } } public string Ticker { get { return ticker; } } } </script> </head> <body> <h3>Repeater Example</h3> <form runat=server> <b>Repeater1:</b> <p> <asp:Repeater id=Repeater1 OnItemCommand="R1_ItemCommand" runat="server"> <HeaderTemplate> <table border=1> <tr> <td><b>Company</b></td> <td><b>Symbol</b></td> </tr> </HeaderTemplate> <ItemTemplate> <tr> <td> <%# DataBinder.Eval(Container.DataItem, "Name") %> </td> <td> <asp:Button Text=<%# DataBinder.Eval(Container.DataItem, "Ticker") %> runat="server" /></td> </tr> </ItemTemplate> <FooterTemplate> </table> </FooterTemplate> </asp:Repeater> <p> <asp:Label id=Label2 font-name="Verdana" ForeColor="Green" font-size="10pt" runat="server"/> </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 | RepeaterItemCollection