RepeaterItem 类

表示 Repeater 控件中的项。

**命名空间:**System.Web.UI.WebControls
**程序集:**System.Web(在 system.web.dll 中)

语法

声明
Public Class RepeaterItem
    Inherits Control
    Implements IDataItemContainer, INamingContainer
用法
Dim instance As RepeaterItem
public class RepeaterItem : Control, IDataItemContainer, INamingContainer
public ref class RepeaterItem : public Control, IDataItemContainer, INamingContainer
public class RepeaterItem extends Control implements IDataItemContainer, INamingContainer
public class RepeaterItem extends Control implements IDataItemContainer, INamingContainer

备注

RepeaterItem 对象表示 Repeater 控件中的项,如标题部分、脚注部分或数据项。

Repeater 控件的数据项存储在 RepeaterItemCollection 对象中,通过使用 Repeater 控件的 Items 属性可以访问该对象。

可以使用 RepeaterItem 对象以编程方式访问 Repeater 控件中某项的属性。

示例

下面的示例说明如何使用 RepeaterItem 对象来显示 Repeater 控件中的每个数据项的内容。

<%@ 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>
<%@ 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>

继承层次结构

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

线程安全

此类型的任何公共静态(Visual Basic 中的 Shared)成员都是线程安全的,但不保证所有实例成员都是线程安全的。

平台

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

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表,请参见系统要求

版本信息

.NET Framework

受以下版本支持:2.0、1.1、1.0

请参见

参考

RepeaterItem 成员
System.Web.UI.WebControls 命名空间
Repeater 类
RepeaterItemCollection
Repeater.Items 属性