DataListItem イベント
パブリック イベント| 名前 | 説明 | |
|---|---|---|
| DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。 ( Control から継承されます。) |
| Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。 ( Control から継承されます。) |
| Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。 ( Control から継承されます。) |
| Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。 ( Control から継承されます。) |
| PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。 ( Control から継承されます。) |
| Unload | サーバー コントロールがメモリからアンロードされると発生します。 ( Control から継承されます。) |
参照DataListItem クラス
アセンブリ: System.Web (system.web.dll 内)
構文
解説DataListItem は、見出しセクション、フッター セクション、データ項目など、DataList コントロールの項目を表します。
DataList コントロールのデータ項目は DataListItemCollection に格納されています。このオブジェクトには DataList コントロールの Items プロパティを使用してアクセスできます。
DataListItem を使用すると、DataList コントロール内の項目のプロパティにプログラムによってアクセスできます。
使用例DataListItem を使用して、DataList コントロールの各データ項目の内容を表示する方法を次の例に示します。
メモ |
|---|
| 次のコード サンプルはシングルファイル コード モデルを使用しており、分離コード ファイルに直接コピーされた場合は正常に動作しない可能性があります。このコード サンプルは、拡張子が .aspx の空のテキスト ファイルにコピーする必要があります。Web フォームのコード モデルの詳細については、「ASP.NET Web ページのコード モデル」を参照してください。 |
<%@ Page Language="VB" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <html> <script runat="server"> Function CreateDataSource() As ICollection ' Create sample data for the DataList control. Dim dt As DataTable = New DataTable() Dim dr As DataRow ' Define the columns of the table. dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32))) dt.Columns.Add(New DataColumn("StringValue", GetType(String))) dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double))) ' Populate the table with sample values. Dim i As Integer For i = 0 To 8 dr = dt.NewRow() dr(0) = i dr(1) = "Description for item " & i.ToString() dr(2) = 1.23 * (i + 1) dt.Rows.Add(dr) Next i Dim dv As DataView = New DataView(dt) Return dv End Function Sub Page_Load(sender As Object, e As EventArgs) ' Load sample data only once, when the page is first loaded. If Not IsPostBack Then ItemsList.DataSource = CreateDataSource() ItemsList.DataBind() End If End Sub Sub Item_Created(sender As Object, e As DataListItemEventArgs) If e.Item.ItemType = ListItemType.Item Or _ e.Item.ItemType = ListItemType.AlternatingItem Then ' Retrieve the Label control in the current DataListItem. Dim PriceLabel As Label = _ CType(e.Item.FindControl("PriceLabel"), Label) ' Retrieve the text of the CurrencyColumn from the DataListItem ' and convert the value to a Double. Dim Price As Double = Convert.ToDouble( _ (CType(e.Item.DataItem, DataRowView)).Row.ItemArray(2).ToString()) ' Format the value as currency and redisplay it in the DataList. PriceLabel.Text = Price.ToString("c") End If End Sub </script> <body> <form runat=server> <h3>DataList ItemCreated Example</h3> <asp:DataList id="ItemsList" BorderColor="black" CellPadding="5" CellSpacing="5" RepeatDirection="Vertical" RepeatLayout="Table" RepeatColumns="3" ShowBorder="True" OnItemCreated="Item_Created" runat="server"> <HeaderStyle BackColor="#aaaadd"> </HeaderStyle> <AlternatingItemStyle BackColor="Gainsboro"> </AlternatingItemStyle> <HeaderTemplate> List of items </HeaderTemplate> <ItemTemplate> Description: <br> <%# DataBinder.Eval(Container.DataItem, "StringValue") %> <br> Price: <asp:Label id="PriceLabel" runat="server"/> </ItemTemplate> </asp:DataList> </form> </body> </html>
<%@ Page Language="C#" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <html> <script runat="server"> ICollection CreateDataSource() { // Create sample data for the DataList control. DataTable dt = new DataTable(); DataRow dr; // Define the columns of the table. dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32))); dt.Columns.Add(new DataColumn("StringValue", typeof(String))); dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double))); // Populate the table with sample values. for (int i = 0; i < 9; i++) { dr = dt.NewRow(); dr[0] = i; dr[1] = "Description for item " + i.ToString(); dr[2] = 1.23 * (i + 1); dt.Rows.Add(dr); } DataView dv = new DataView(dt); return dv; } void Page_Load(Object sender, EventArgs e) { // Load sample data only once, when the page is first loaded. if (!IsPostBack) { ItemsList.DataSource = CreateDataSource(); ItemsList.DataBind(); } } void Item_Created(Object sender, DataListItemEventArgs e) { if (e.Item.ItemType == ListItemType.Item || e.Item.ItemType == ListItemType.AlternatingItem) { // Retrieve the Label control in the current DataListItem. Label PriceLabel = (Label)e.Item.FindControl("PriceLabel"); // Retrieve the text of the CurrencyColumn from the DataListItem // and convert the value to a Double. Double Price = Convert.ToDouble( ((DataRowView)e.Item.DataItem).Row.ItemArray[2].ToString()); // Format the value as currency and redisplay it in the DataList. PriceLabel.Text = Price.ToString("c"); } } </script> <body> <form runat=server> <h3>DataList ItemCreated Example</h3> <asp:DataList id="ItemsList" BorderColor="black" CellPadding="5" CellSpacing="5" RepeatDirection="Vertical" RepeatLayout="Table" RepeatColumns="3" ShowBorder="True" OnItemCreated="Item_Created" runat="server"> <HeaderStyle BackColor="#aaaadd"> </HeaderStyle> <AlternatingItemStyle BackColor="Gainsboro"> </AlternatingItemStyle> <HeaderTemplate> List of items </HeaderTemplate> <ItemTemplate> Description: <br> <%# DataBinder.Eval(Container.DataItem, "StringValue") %> <br> Price: <asp:Label id="PriceLabel" runat="server"/> </ItemTemplate> </asp:DataList> </form> </body> </html>
.NET Framework のセキュリティ
継承階層System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.DataListItem
スレッド セーフ
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報
参照DataListItem コンストラクタ
アセンブリ: System.Web (system.web.dll 内)
構文Dim itemIndex As Integer Dim itemType As ListItemType Dim instance As New DataListItem(itemIndex, itemType)
- itemType
ListItemType 値の 1 つ。
解説
使用例DataListItem クラスの新しいインスタンスを作成および初期化する方法を次の例に示します。
Sub Page_Load(sender As Object, e As EventArgs) Dim index As Integer = 0 Dim myItem As New DataListItem(index, ListItemType.Item) End Sub 'Page_Load
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報
参照DataListItem プロパティ
パブリック プロパティ
プロテクト プロパティ
明示的インターフェイスの実装| 名前 | 説明 | |
|---|---|---|
| System.Web.UI.IDataItemContainer.DataItem | このメンバの説明については、IDataItemContainer.DataItem のトピックを参照してください。 |
| System.Web.UI.IDataItemContainer.DataItemIndex | このメンバの説明については、IDataItemContainer.DataItemIndex のトピックを参照してください。 |
| System.Web.UI.IDataItemContainer.DisplayIndex | このメンバの説明については、IDataItemContainer.DisplayIndex のトピックを参照してください。 |
参照DataListItem メソッド
パブリック メソッド
プロテクト メソッド
参照DataListItem メンバ
DataListItem データ型で公開されるメンバを以下の表に示します。
パブリック コンストラクタ
パブリック プロパティ
プロテクト プロパティ
パブリック メソッド
プロテクト メソッド
パブリック イベント| 名前 | 説明 | |
|---|---|---|
| DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。(Control から継承されます。) |
| Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。(Control から継承されます。) |
| Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。(Control から継承されます。) |
| Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。(Control から継承されます。) |
| PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。(Control から継承されます。) |
| Unload | サーバー コントロールがメモリからアンロードされると発生します。(Control から継承されます。) |
明示的インターフェイスの実装| 名前 | 説明 | |
|---|---|---|
| System.Web.UI.IDataItemContainer.DataItem | このメンバの説明については、IDataItemContainer.DataItem のトピックを参照してください。 |
| System.Web.UI.IDataItemContainer.DataItemIndex | このメンバの説明については、IDataItemContainer.DataItemIndex のトピックを参照してください。 |
| System.Web.UI.IDataItemContainer.DisplayIndex | このメンバの説明については、IDataItemContainer.DisplayIndex のトピックを参照してください。 |
参照- DataListItemのページへのリンク
.gif)