RepeaterItem-Klasse
Stellt ein Element im Repeater-Steuerelement dar.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Class RepeaterItem
Inherits Control
Implements IDataItemContainer, INamingContainer
'Usage
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
Hinweise
Ein RepeaterItem-Objekt stellt ein Element im Repeater-Steuerelement dar, z. B. den Kopfzeilenbereich, den Fußzeilenbereich oder ein Datenelement.
Die Datenelemente des Repeater-Steuerelements werden in einem RepeaterItemCollection-Objekt gespeichert, auf das mit der Items-Eigenschaft des Repeater-Steuerelements zugegriffen werden kann.
Mit einem RepeaterItem-Objekt können Sie programmgesteuert auf die Eigenschaften eines Elements im Repeater-Steuerelement zugreifen.
Beispiel
Im folgenden Beispiel wird veranschaulicht, wie mit einem RepeaterItem-Objekt der Inhalt jedes Datenelements im Repeater-Steuerelement angezeigt wird.
<%@ 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>
Vererbungshierarchie
System.Object
System.Web.UI.Control
System.Web.UI.WebControls.RepeaterItem
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
RepeaterItem-Member
System.Web.UI.WebControls-Namespace
Repeater-Klasse
RepeaterItemCollection
Repeater.Items-Eigenschaft