ASP.NET Web Forms - DataList コントロール
DataList コントロールは、Repeater コントロールと似ており、そのコントロールにバインドされた項目の繰り返しリストを表示するために使用されます。ただし、DataList コントロールはデフォルトでデータ項目にテーブルを追加します。
DataSet を DataList コントロールにバインドする
DataList コントロールは、Repeater コントロールと似ており、そのコントロールにバインドされた項目の繰り返しリストを表示するために使用されます。ただし、DataList コントロールはデフォルトでデータ項目にテーブルを追加します。DataList コントロールは、データベーステーブル、XML ファイル、またはその他の項目リストにバインドできます。ここでは、XML ファイルを DataList コントロールにバインドする方法を説明します。
この例では、次の XML ファイル（"cdcatalog.xml"）を使用します。
<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>
この XML ファイルを表示：
まず、"System.Data" 名前空間をインポートします。DataSet オブジェクトを操作するには、この名前空間が必要です。次のディレクティブを .aspx ページの先頭に含めます：
次に、XML ファイル用の DataSet を作成し、ページが最初に読み込まれたときにこの XML ファイルを DataSet に読み込みます：
sub Page_Load
if Not Page.IsPostBack then
dim mycdcatalog=New DataSet
mycdcatalog.ReadXml(MapPath("cdcatalog.xml"))
end if
end sub
次に、.aspx ページに DataList コントロールを作成します。<HeaderTemplate> 要素の内容は最初にレンダリングされ、出力に一度だけ表示されます。<ItemTemplate> 要素の内容は、DataSet 内の各 "record" ごとに繰り返し表示されます。最後に、<FooterTemplate> 要素の内容は出力に一度だけ表示されます：
<body>
<form runat="server">
<asp:DataList id="cdcatalog" runat="server">
<HeaderTemplate>
...
</HeaderTemplate>
<ItemTemplate>
...
</ItemTemplate>
<FooterTemplate>
...
</FooterTemplate>
</asp:DataList>
</form>
</body>
</html>
次に、DataSet を作成するスクリプトを追加し、mycdcatalog DataSet を DataList コントロールにバインドします。次に、ヘッダーを含む <HeaderTemplate>、表示するデータ項目を含む <ItemTemplate>、テキストを含む <FooterTemplate> を使用して DataList コントロールを設定します。DataList の gridlines プロパティを "both" に設定すると、テーブルの枠線を表示できることに注意してください：
例
<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")%>" of
<%#Container.DataItem("artist")%> -
$<%#Container.DataItem("price")%>
</ItemTemplate>
<FooterTemplate>
Copyright Hege Refsnes
</FooterTemplate>
</asp:DataList>
</form>
</body>
</html>
例を表示 »
スタイルを使用する
DataList コントロールにスタイルを追加して、出力をより派手にすることもできます：
例
<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")%>" of
<%#Container.DataItem("artist")%> -
$<%#Container.DataItem("price")%>
</ItemTemplate>
<FooterTemplate>
Copyright Hege Refsnes
</FooterTemplate>
</asp:DataList>
</form>
</body>
</html>
例を表示 »
<AlternatingItemTemplate> を使用する
<ItemTemplate> 要素の後に <AlternatingItemTemplate> 要素を追加して、出力内の交互行の外観を記述できます。DataList コントロール内の <AlternatingItemTemplate> 領域のデータにスタイルを追加できます：
例
<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")%>" of
<%#Container.DataItem("artist")%> -
$<%#Container.DataItem("price")%>
</ItemTemplate>
<AlternatingItemTemplate>
"<%#Container.DataItem("title")%>" of
<%#Container.DataItem("artist")%> -
$<%#Container.DataItem("price")%>
</AlternatingItemTemplate>
<FooterTemplate>
© Hege Refsnes
</FooterTemplate>
</asp:DataList>
</form>
</body>
</html>
例を表示 »
その他の拡張