RepeaterItem Class (System.Web.UI.WebControls)

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

RepeaterItem Class

Updated: November 2007

Represents an item in the Repeater control.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)

Syntax

Visual Basic (Declaration)

<AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
Public Class RepeaterItem _
    Inherits Control _
    Implements IDataItemContainer, INamingContainer

Visual Basic (Usage)

Dim instance As RepeaterItem

[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class RepeaterItem : Control, 
    IDataItemContainer, INamingContainer

Visual C++

[AspNetHostingPermissionAttribute(SecurityAction::LinkDemand, Level = AspNetHostingPermissionLevel::Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction::InheritanceDemand, Level = AspNetHostingPermissionLevel::Minimal)]
public ref class RepeaterItem : public Control, 
    IDataItemContainer, INamingContainer

/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public class RepeaterItem extends Control implements IDataItemContainer, 
    INamingContainer

JScript

public class RepeaterItem extends Control implements IDataItemContainer, INamingContainer

ASP.NET

<asp:RepeaterItem />

Remarks

A RepeaterItem object represents an item in the Repeater control, such as the heading section, footer section, or a data item.

The data items of the Repeater control are stored in a RepeaterItemCollection object that can be accessed by using the Items property of the Repeater control.

You can use a RepeaterItem object to programmatically access the properties of an item in the Repeater control.

Examples

The following example demonstrates how to use a RepeaterItem object to display the contents of each data item in the Repeater control.

Visual Basic

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html  >
<head>
    <title>Repeater Example</title>
<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("Item 1", "$6.00"))
            values.Add(New PositionData("Item 2", "$7.48"))
            values.Add(New PositionData("Item 3", "$9.96"))

            Repeater1.DataSource = values
            Repeater1.DataBind()
        End If
    End Sub

    Sub Button_Click(Sender As Object, e As EventArgs)
        Label1.Text = "The Items collection contains: <br />"

        Dim item As RepeaterItem
        For Each item In  Repeater1.Items
            Label1.Text &= _
                CType(item.Controls(0), DataBoundLiteralControl).Text & "<br />"
        Next item
    End Sub

    Public Class PositionData

        Private myItem As String
        Private myPrice As String        

        Public Sub New(newItem As String, newPrice As String)
            Me.myItem = newItem
            Me.myPrice = newPrice
        End Sub        

        Public ReadOnly Property Item() As String
            Get
                Return myItem
            End Get
        End Property        

        Public ReadOnly Property Price() As String
            Get
                Return myPrice
            End Get
        End Property
    End Class

   </script>

</head>
<body>

   <form id="form1" runat="server">

      <h3>Repeater Example</h3>

      <br />

      <asp:Repeater id="Repeater1" 
                    runat="server">
         <HeaderTemplate>
            <table border="1">
               <tr>
                  <td><b>Item</b></td>
                  <td><b>Price</b></td>
               </tr>
         </HeaderTemplate>

         <ItemTemplate>
            <tr>
               <td> <%# DataBinder.Eval(Container.DataItem, "Item") %> </td>
               <td> <%# DataBinder.Eval(Container.DataItem, "Price") %> </td>
            </tr>
         </ItemTemplate>

         <FooterTemplate>
            </table>
         </FooterTemplate>

      </asp:Repeater>
      <br />

      <asp:Button id="Button1"
           Text="Display Items in Repeater"
           OnClick="Button_Click"
           runat="server"/>

      <br /><br />

      <asp:Label id="Label1"                 
                 runat="server"/>
   </form>
</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html  >
<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(new PositionData("Item 1", "$6.00"));
            values.Add(new PositionData("Item 2", "$7.48"));
            values.Add(new PositionData("Item 3", "$9.96"));

            Repeater1.DataSource = values;
            Repeater1.DataBind();
         }

      }
      void Button_Click(Object Sender, EventArgs e) 
      {        
         Label1.Text = "The Items collection contains: <br />";

         foreach(RepeaterItem item in Repeater1.Items)
         {        
            Label1.Text += ((DataBoundLiteralControl)item.Controls[0]).Text +
                              "<br />";
         }
      }    

      public class PositionData 
      {

         private string item;
         private string price;

         public PositionData(string item, string price) 
         {
            this.item = item;
            this.price = price;
         }

         public string Item 
         {
            get 
            {
               return item;
            }
         }

         public string Price 
         {
            get 
            {
               return price;
            }
         }
      }

   </script>

</head>
<body>

   <form id="form1" runat="server">

      <h3>Repeater Example</h3>

      <br />

      <asp:Repeater id="Repeater1" 
                    runat="server">
         <HeaderTemplate>
            <table border="1">
               <tr>
                  <td><b>Item</b></td>
                  <td><b>Price</b></td>
               </tr>
         </HeaderTemplate>

         <ItemTemplate>
            <tr>
               <td> <%# DataBinder.Eval(Container.DataItem, "Item") %> </td>
               <td> <%# DataBinder.Eval(Container.DataItem, "Price") %> </td>
            </tr>
         </ItemTemplate>

         <FooterTemplate>
            </table>
         </FooterTemplate>

      </asp:Repeater>
      <br />

      <asp:Button id="Button1"
           Text="Display Items in Repeater"
           OnClick="Button_Click"
           runat="server"/>

      <br /><br />

      <asp:Label id="Label1"                 
                 runat="server"/>
   </form>
</body>
</html>

Permissions

AspNetHostingPermission
for operating in a hosted environment. Demand value: LinkDemand; Permission value: Minimal.
AspNetHostingPermission
for operating in a hosted environment. Demand value: InheritanceDemand; Permission value: Minimal.

Inheritance Hierarchy

System..::.Object
System.Web.UI..::.Control
System.Web.UI.WebControls..::.RepeaterItem

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

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

Reference

RepeaterItem Members

System.Web.UI.WebControls Namespace

Repeater

RepeaterItemCollection

Items

Product Families

Resources

About Microsoft

Popular Places

Popular Searches

Popular Downloads

.NET Framework

Reference