ASP.NET Web Forms – Repeater-Steuerelement


Das Repeater-Steuerelement wird verwendet, um eine wiederholte Liste von an das Steuerelement gebundenen Elementen anzuzeigen.


DataSet an Repeater-Steuerelement binden

Das Repeater-Steuerelement wird verwendet, um eine wiederholte Liste von Elementen anzuzeigen, die an das Steuerelement gebunden sind. Das Repeater-Steuerelement kann an eine Datenbanktabelle, eine XML-Datei oder eine andere Liste von Elementen gebunden werden. Hier zeigen wir, wie eine XML-Datei an das Repeater-Steuerelement gebunden wird.

In unserem Beispiel verwenden wir die folgende XML-Datei ("cdcatalog.xml"):.

<?xml version="1.0" encoding="ISO-8859-1"?>

<catalog>
<cd>
<title>Empire Burlesque</title>
<artist>Bob Dylan</artist>
<country>USA</country>
<company>Columbia</company>
<price>10.90</price>
<year>1985</year>
</cd>
<cd>
<title>Hide your heart</title>
<artist>Bonnie Tyler</artist>
<country>UK</country>
<company>CBS Records</company>
<price>9.90</price>
<year>1988</year>
</cd>
<cd>
<title>Greatest Hits</title>
<artist>Dolly Parton</artist>
<country>USA</country>
<company>RCA</company>
<price>9.90</price>
<year>1982</year>
</cd>
<cd>
<title>Still got the blues</title>
<artist>Gary Moore</artist>
<country>UK</country>
<company>Virgin records</company>
<price>10.20</price>
<year>1990</year>
</cd>
<cd>
<title>Eros</title>
<artist>Eros Ramazzotti</artist>
<country>EU</country>
<company>BMG</company>
<price>9.90</price>
<year>1997</year>
</cd>
</catalog>

Diese XML-Datei anzeigen:

Importieren Sie zuerst den Namespace "System.Data". Wir benötigen diesen Namespace, um mit dem DataSet-Objekt zu arbeiten. Fügen Sie die folgende Direktive oben auf der .aspx-Seite ein:

<%@ Import Namespace="System.Data" %>

Erstellen Sie als Nächstes ein DataSet für die XML-Datei und laden Sie die XML-Datei beim ersten Laden der Seite in das DataSet:

<script runat="server">
sub Page_Load
if Not Page.IsPostBack then
dim mycdcatalog=New DataSet
mycdcatalog.ReadXml(MapPath("cdcatalog.xml"))
end if
end sub

Dann erstellen wir ein Repeater-Steuerelement auf der .aspx-Seite. Der Inhalt im <HeaderTemplate>-Element wird zuerst gerendert und erscheint nur einmal in der Ausgabe, während der Inhalt im <ItemTemplate>-Element für jeden „Datensatz“ im DataSet wiederholt wird. Schließlich erscheint der Inhalt im <FooterTemplate>-Element nur einmal in der Ausgabe:

<html>
<body>

<form runat="server">
<asp:Repeater id="cdcatalog" runat="server">

<HeaderTemplate>
...
</HeaderTemplate>

<ItemTemplate>
...
</ItemTemplate>

<FooterTemplate>
...
</FooterTemplate>

</asp:Repeater>
</form>

</body>
</html>

Dann fügen wir das Skript hinzu, das das DataSet erstellt und das mycdcatalog-DataSet an das Repeater-Steuerelement bindet. Anschließend verwenden wir HTML-Tags, um das Repeater-Steuerelement zu füllen, und binden Datenelemente mit <%#Container.DataItem("fieldname")%> an die Zellen im <ItemTemplate>-Bereich:

Beispiel

<%@ Import Namespace="System.Data" %>

<script runat="server">
sub Page_Load
if Not Page.IsPostBack then
dim mycdcatalog=New DataSet
mycdcatalog.ReadXml(MapPath("cdcatalog.xml"))
cdcatalog.DataSource=mycdcatalog
cdcatalog.DataBind()
end if
end sub
</script>

<html>
<body>

<form runat="server">
<asp:Repeater id="cdcatalog" runat="server">

<HeaderTemplate>
<table border="1" width="100%">
<tr>
<th>Title</th>
<th>Artist</th>
<th>Land</th>
<th>Company</th>
<th>Price</th>
<th>Year</th>
</tr>
</HeaderTemplate>

<ItemTemplate>
<tr>
<td><%#Container.DataItem("title")%></td>
<td><%#Container.DataItem("artist")%></td>
<td><%#Container.DataItem("country")%></td>
<td><%#Container.DataItem("company")%></td>
<td><%#Container.DataItem("price")%></td>
<td><%#Container.DataItem("year")%></td>
</tr>
</ItemTemplate>

<FooterTemplate>
</table>
</FooterTemplate>

</asp:Repeater>
</form>

</body>
</html>

Beispiel anzeigen »

Verwenden von <AlternatingItemTemplate>

Sie können ein <AlternatingItemTemplate>-Element nach dem <ItemTemplate>-Element hinzufügen, um das Aussehen von abwechselnden Zeilen in der Ausgabe zu beschreiben. Im folgenden Beispiel hat jede zweite Zeile in der Tabelle einen hellgrauen Hintergrund:

Beispiel

<%@ Import Namespace="System.Data" %>

<script runat="server">
sub Page_Load
if Not Page.IsPostBack then
dim mycdcatalog=New DataSet
mycdcatalog.ReadXml(MapPath("cdcatalog.xml"))
cdcatalog.DataSource=mycdcatalog
cdcatalog.DataBind()
end if
end sub
</script>

<html>
<body>

<form runat="server">
<asp:Repeater id="cdcatalog" runat="server">

<HeaderTemplate>
<table border="1" width="100%">
<tr>
<th>Title</th>
<th>Artist</th>
<th>Land</th>
<th>Company</th>
<th>Price</th>
<th>Year</th>
</tr>
</HeaderTemplate>

<ItemTemplate>
<tr>
<td><%#Container.DataItem("title")%></td>
<td><%#Container.DataItem("artist")%></td>
<td><%#Container.DataItem("country")%></td>
<td><%#Container.DataItem("company")%></td>
<td><%#Container.DataItem("price")%></td>
<td><%#Container.DataItem("year")%></td>
</tr>
</ItemTemplate>

<AlternatingItemTemplate>
<tr bgcolor="#e8e8e8">
<td><%#Container.DataItem("title")%></td>
<td><%#Container.DataItem("artist")%></td>
<td><%#Container.DataItem("country")%></td>
<td><%#Container.DataItem("company")%></td>
<td><%#Container.DataItem("price")%></td>
<td><%#Container.DataItem("year")%></td>
</tr>
</AlternatingItemTemplate>

<FooterTemplate>
</table>
</FooterTemplate>

</asp:Repeater>
</form>

</body>
</html>

Beispiel anzeigen »

Verwendung von <SeparatorTemplate>

Das <SeparatorTemplate>-Element wird verwendet, um das Trennzeichen zwischen den einzelnen Datensätzen zu beschreiben. Im folgenden Beispiel wird eine horizontale Linie zwischen den Tabellenzeilen eingefügt:

Beispiel

<%@ Import Namespace="System.Data" %>

<script runat="server">
sub Page_Load
if Not Page.IsPostBack then
dim mycdcatalog=New DataSet
mycdcatalog.ReadXml(MapPath("cdcatalog.xml"))
cdcatalog.DataSource=mycdcatalog
cdcatalog.DataBind()
end if
end sub
</script>

<html>
<body>

<form runat="server">
<asp:Repeater id="cdcatalog" runat="server">

<HeaderTemplate>
<table border="0" width="100%">
<tr>
<th>Title</th>
<th>Artist</th>
<th>Land</th>
<th>Company</th>
<th>Price</th>
<th>Year</th>
</tr>
</HeaderTemplate>

<ItemTemplate>
<tr>
<td><%#Container.DataItem("title")%></td>
<td><%#Container.DataItem("artist")%></td>
<td><%#Container.DataItem("country")%></td>
<td><%#Container.DataItem("company")%></td>
<td><%#Container.DataItem("price")%></td>
<td><%#Container.DataItem("year")%></td>
</tr>
</ItemTemplate>

<SeparatorTemplate>
<tr>
<td colspan="6"><hr /></td>
</tr>
</SeparatorTemplate>

<FooterTemplate>
</table>
</FooterTemplate>

</asp:Repeater>
</form>

</body>
</html>

Beispiel anzeigen »

Andere Erweiterungen