DataList.Items プロパティ
コントロール内の個別の項目を表す DataListItem オブジェクトのコレクションを取得します。
名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文
解説
使用例
プラットフォーム
バージョン情報
参照
アセンブリ: System.Web (system.web.dll 内)
構文
プロパティ値
DataList コントロール内の個別の項目を表す DataListItem オブジェクトのコレクションを格納している DataListItemCollection。
DataList コントロール内の個別の項目を表す DataListItem オブジェクトのコレクションを格納している DataListItemCollection。
解説Items コレクションを使用して、DataList コントロールの項目をプログラムによって制御します。Items コレクションには、コレクションに項目を追加または削除するメソッドは用意されていません。ただし、ItemCreated イベントのハンドラを作成することによって、項目の内容を制御できます。
.gif) メモ |
|---|
| データ ソースに連結された項目だけが、Items コレクションに格納されます。ヘッダー、フッター、および区切り記号は、コレクションに含まれません。 |
使用例Items コレクションを使用して、DataList コントロールに項目を表示する方法のコード例を次に示します。
| メモ |
|---|
| 次のコード サンプルはシングルファイル コード モデルを使用しており、分離コード ファイルに直接コピーされた場合は正常に動作しない可能性があります。このコード サンプルは、拡張子が .aspx の空のテキスト ファイルにコピーする必要があります。Web フォームのコード モデルの詳細については、「ASP.NET Web ページのコード モデル」を参照してください。 |
<%@ Page Language="VB" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <html> <script language = "VB" runat="server"> Function CreateDataSource() As ICollection Dim dt As New DataTable() Dim dr As DataRow dt.Columns.Add(New DataColumn("StringValue", GetType(String))) Dim i As Integer For i = 0 To 9 dr = dt.NewRow() dr(0) = "Item " & i.ToString() dt.Rows.Add(dr) Next i Dim dv As New DataView(dt) Return dv End Function 'CreateDataSource Sub Page_Load(sender As Object, e As EventArgs) If Not IsPostBack Then DataList1.DataSource = CreateDataSource() DataList1.DataBind() End If End Sub 'Page_Load Sub Button_Click(sender As Object, e As EventArgs) If DataList1.Items.Count > 0 Then Label1.Text = "The Items collection contains: <br>" Dim item As DataListItem For Each item In DataList1.Items Label1.Text += CType(item.Controls(0), DataBoundLiteralControl).Text & "<br>" Next item End If End Sub 'Button_Click </script> <body> <form runat=server> <h3>DataList Items Example</h3> <asp:DataList id="DataList1" runat="server" BorderColor="black" CellPadding="3" Font-Name="Verdana" Font-Size="8pt"> <HeaderStyle BackColor="#aaaadd"> </HeaderStyle> <AlternatingItemStyle BackColor="Gainsboro"> </AlternatingItemStyle> <HeaderTemplate> Items </HeaderTemplate> <ItemTemplate> <%# DataBinder.Eval(Container.DataItem, "StringValue") %> </ItemTemplate> </asp:DataList> <br><br> <asp:Button id="Button1" Text="Display Contents of Items Collection" 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> <script language = "C#" runat="server"> ICollection CreateDataSource() { DataTable dt = new DataTable(); DataRow dr; dt.Columns.Add(new DataColumn("StringValue", typeof(string))); for (int i = 0; i < 10; i++) { dr = dt.NewRow(); dr[0] = "Item " + i.ToString(); dt.Rows.Add(dr); } DataView dv = new DataView(dt); return dv; } void Page_Load(Object sender, EventArgs e) { if (!IsPostBack) { DataList1.DataSource = CreateDataSource(); DataList1.DataBind(); } } void Button_Click(Object sender, EventArgs e) { if (DataList1.Items.Count > 0) { Label1.Text = "The Items collection contains: <br>"; foreach(DataListItem item in DataList1.Items) { Label1.Text += ((DataBoundLiteralControl)item.Controls[0]).Text + "<br>"; } } } </script> <body> <form runat=server> <h3>DataList Items Example</h3> <asp:DataList id="DataList1" runat="server" BorderColor="black" CellPadding="3" Font-Name="Verdana" Font-Size="8pt"> <HeaderStyle BackColor="#aaaadd"> </HeaderStyle> <AlternatingItemStyle BackColor="Gainsboro"> </AlternatingItemStyle> <HeaderTemplate> Items </HeaderTemplate> <ItemTemplate> <%# DataBinder.Eval(Container.DataItem, "StringValue") %> </ItemTemplate> </asp:DataList> <br><br> <asp:Button id="Button1" Text="Display Contents of Items Collection" OnClick="Button_Click" runat="server"/> <br><br> <asp:Label id="Label1" runat="server"/> </form> </body> </html>
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- DataList.Items プロパティのページへのリンク
