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 属性