ASP.NET Web Forms - DataList-Steuerelement


Das DataList-Steuerelement ähnelt dem Repeater-Steuerelement und wird verwendet, um eine wiederholte Liste von Elementen anzuzeigen, die an das Steuerelement gebunden sind. Das DataList-Steuerelement fügt den Datenelementen standardmäßig jedoch eine Tabelle hinzu.


DataSet an DataList-Steuerelement binden

Das DataList-Steuerelement ähnelt dem Repeater-Steuerelement und wird verwendet, um eine wiederholte Liste von Elementen anzuzeigen, die an das Steuerelement gebunden sind. Das DataList-Steuerelement fügt den Datenelementen standardmäßig jedoch eine Tabelle hinzu. Das DataList-Steuerelement kann an Datenbanktabellen, XML-Dateien oder andere Elementlisten gebunden werden. Hier zeigen wir, wie Sie eine XML-Datei an das DataList-Steuerelement binden.

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 DataList-Steuerelement auf der .aspx-Seite. Der Inhalt im <HeaderTemplate>-Element wird zuerst gerendert und erscheint nur einmal in der Ausgabe, während sich der Inhalt im <ItemTemplate>-Element für jeden "Datensatz" im DataSet wiederholt. Schließlich erscheint der Inhalt im <FooterTemplate>-Element nur einmal in der Ausgabe:

<html>
<body>

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

<HeaderTemplate>
...
</HeaderTemplate>

<ItemTemplate>
...
</ItemTemplate>

<FooterTemplate>
...
</FooterTemplate>

</asp:DataList>
</form>

</body>
</html>

Dann fügen wir das Skript hinzu, das das DataSet erstellt und das mycdcatalog-DataSet an das DataList-Steuerelement bindet. Füllen Sie dann das DataList-Steuerelement mit <HeaderTemplate> für den Header, <ItemTemplate> für die anzuzeigenden Datenelemente und <FooterTemplate> für den Text. Beachten Sie, dass Sie die gridlines-Eigenschaft des DataList-Steuerelements auf "both" setzen können, um Tabellenränder anzuzeigen:

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:DataList id="cdcatalog"
gridlines="both" runat="server">

<HeaderTemplate>
My CD Catalog
</HeaderTemplate>

<ItemTemplate>
"<%#Container.DataItem("title")%>" von
<%#Container.DataItem("artist")%> -
$<%#Container.DataItem("price")%>
</ItemTemplate>

<FooterTemplate>
Copyright Hege Refsnes
</FooterTemplate>

</asp:DataList>
</form>

</body>
</html>

Demobeispiel »

Verwenden von Styles

Sie können dem DataList-Steuerelement auch Styles hinzufügen, um die Ausgabe ansprechender zu gestalten:

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:DataList id="cdcatalog"
runat="server"
cellpadding="2"
cellspacing="2"
borderstyle="inset"
backcolor="#e8e8e8"
width="100%"
headerstyle-font-name="Verdana"
headerstyle-font-size="12pt"
headerstyle-horizontalalign="center"
headerstyle-font-bold="true"
itemstyle-backcolor="#778899"
itemstyle-forecolor="#ffffff"
footerstyle-font-size="9pt"
footerstyle-font-italic="true">

<HeaderTemplate>
My CD Catalog
</HeaderTemplate>

<ItemTemplate>
"<%#Container.DataItem("title")%>" von
<%#Container.DataItem("artist")%> -
$<%#Container.DataItem("price")%>
</ItemTemplate>

<FooterTemplate>
Copyright Hege Refsnes
</FooterTemplate>

</asp:DataList>
</form>

</body>
</html>

Demobeispiel »

Verwenden von <AlternatingItemTemplate>

Sie können nach dem <ItemTemplate>-Element ein <AlternatingItemTemplate>-Element hinzufügen, um das Erscheinungsbild alternierender Zeilen in der Ausgabe zu beschreiben. Sie können den Daten im <AlternatingItemTemplate>-Bereich innerhalb des DataList-Steuerelements Styles hinzufügen:

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:DataList id="cdcatalog"
runat="server"
cellpadding="2"
cellspacing="2"
borderstyle="inset"
backcolor="#e8e8e8"
width="100%"
headerstyle-font-name="Verdana"
headerstyle-font-size="12pt"
headerstyle-horizontalalign="center"
headerstyle-font-bold="True"
itemstyle-backcolor="#778899"
itemstyle-forecolor="#ffffff"
alternatingitemstyle-backcolor="#e8e8e8"
alternatingitemstyle-forecolor="#000000"
footerstyle-font-size="9pt"
footerstyle-font-italic="True">

<HeaderTemplate>
My CD Catalog
</HeaderTemplate>

<ItemTemplate>
"<%#Container.DataItem("title")%>" von
<%#Container.DataItem("artist")%> -
$<%#Container.DataItem("price")%>
</ItemTemplate>

<AlternatingItemTemplate>
"<%#Container.DataItem("title")%>" von
<%#Container.DataItem("artist")%> -
$<%#Container.DataItem("price")%>
</AlternatingItemTemplate>

<FooterTemplate>
&copy; Hege Refsnes
</FooterTemplate>

</asp:DataList>
</form>

</body>
</html>

Demobeispiel »

Andere Erweiterungen