System.Web.UI.WebControls


.NET Framework Class Library
RepeaterItem Class

Represents an item in the Repeater control.

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

Syntax

Visual Basic (Declaration)
Public Class RepeaterItem
    Inherits Control
    Implements IDataItemContainer, INamingContainer
Visual Basic (Usage)
Dim instance As RepeaterItem
C#
public class RepeaterItem : Control, IDataItemContainer, INamingContainer
C++
public ref class RepeaterItem : public Control, IDataItemContainer, INamingContainer
J#
public class RepeaterItem extends Control implements IDataItemContainer, INamingContainer
JScript
public class RepeaterItem extends Control implements IDataItemContainer, INamingContainer
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.

Example

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" %>
<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("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(1), 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 runat=server>

      <h3>Repeater Example</h3>
         
      <p>
         
      <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>
      <p>

      <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>
C#
<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<html>
<head>

   <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[1]).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 runat=server>

      <h3>Repeater Example</h3>
         
      <p>
         
      <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>
      <p>

      <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>
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 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

Version Information

.NET Framework

Supported in: 2.0, 1.1, 1.0
See Also

Tags :


Page view tracker