DataList クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
テンプレートを使用して項目を表示するデータ連結リスト コントロール。
public ref class DataList : System::Web::UI::WebControls::BaseDataList, System::Web::UI::INamingContainer, System::Web::UI::WebControls::IRepeatInfoUser
public class DataList : System.Web.UI.WebControls.BaseDataList, System.Web.UI.INamingContainer, System.Web.UI.WebControls.IRepeatInfoUser
[System.Web.UI.ControlValueProperty("SelectedValue")]
public class DataList : System.Web.UI.WebControls.BaseDataList, System.Web.UI.INamingContainer, System.Web.UI.WebControls.IRepeatInfoUser
type DataList = class
inherit BaseDataList
interface INamingContainer
interface IRepeatInfoUser
[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type DataList = class
inherit BaseDataList
interface INamingContainer
interface IRepeatInfoUser
Public Class DataList
Inherits BaseDataList
Implements INamingContainer, IRepeatInfoUser
- 継承
- 属性
- 実装
例
次のコード例では、コントロールを使用 DataList してデータ ソースの項目の一覧を表示する方法を示します。
注意
次のコード サンプルでは、単一ファイル コード モデルを使用しており、分離コード ファイルに直接コピーすると正しく動作しない場合があります。 このコード サンプルは、.aspx拡張子を持つ空のテキスト ファイルにコピーする必要があります。 Web フォーム コード モデルの詳細については、「ASP.NET Web フォーム ページ コード モデル」を参照してください。
<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<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)));
dt.Columns.Add(new DataColumn("ImageValue", typeof(String)));
// 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);
dr[3] = "Image" + i.ToString() + ".jpg";
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();
}
}
</script>
<head runat="server">
<title>DataList Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DataList Example</h3>
<asp:DataList id="ItemsList"
BorderColor="black"
CellPadding="5"
CellSpacing="5"
RepeatDirection="Vertical"
RepeatLayout="Table"
RepeatColumns="3"
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: <%# DataBinder.Eval(Container.DataItem, "CurrencyValue", "{0:c}") %>
<br />
<asp:Image id="ProductImage" AlternateText="Product picture"
ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>'
runat="server"/>
</ItemTemplate>
</asp:DataList>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<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)))
dt.Columns.Add(New DataColumn("ImageValue", GetType(String)))
' 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)
dr(3) = "Image" & i.ToString() & ".jpg"
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
</script>
<head runat="server">
<title>DataList Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DataList Example</h3>
<asp:DataList id="ItemsList"
BorderColor="black"
CellPadding="5"
CellSpacing="5"
RepeatDirection="Vertical"
RepeatLayout="Table"
RepeatColumns="3"
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: <%# DataBinder.Eval(Container.DataItem, "CurrencyValue", "{0:c}") %>
<br />
<asp:Image id="ProductImage" AlternateText="Product picture"
ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>'
runat="server"/>
</ItemTemplate>
</asp:DataList>
</form>
</body>
</html>
注釈
このトピックの内容:
はじめに
コントロールを DataList 使用して、テンプレート定義のデータ バインド リストを表示します。 コントロールでは DataList 、選択と編集がサポートされています。
テンプレート
コントロールの DataList 内容は、テンプレートを使用して操作できます。 次の表に、サポートされているテンプレートの一覧を示します。
| テンプレート名 | [説明] |
|---|---|
| AlternatingItemTemplate | 定義されている場合は、 内の交互の項目のコンテンツとレイアウトを提供します DataList。 定義されていない場合は、 ItemTemplate が使用されます。 |
| EditItemTemplate | 定義されている場合は、 で現在編集されているアイテムのコンテンツとレイアウトを提供します DataList。 定義されていない場合は、 ItemTemplate が使用されます。 |
| FooterTemplate | 定義されている場合は、 のフッター セクションのコンテンツとレイアウトを提供します DataList。 定義されていない場合、フッター セクションは表示されません。 |
| HeaderTemplate | 定義されている場合は、 のヘッダー セクションのコンテンツとレイアウトを提供します DataList。 定義されていない場合、ヘッダー セクションは表示されません。 |
| ItemTemplate | 内 DataListの項目のコンテンツとレイアウトを提供する必須のテンプレート。 |
| SelectedItemTemplate | 定義されている場合は、 で現在選択されている項目のコンテンツとレイアウトを提供します DataList。 定義されていない場合は、 ItemTemplate が使用されます。 |
| SeparatorTemplate | 定義されている場合は、 内の項目間の区切り記号のコンテンツとレイアウトを提供します DataList。 定義されていない場合、区切り記号は表示されません。 |
コントロール内の項目を ItemTemplate 表示するには、最低限、 を定義する DataList 必要があります。 追加のテンプレートを使用して、コントロールにカスタムの外観を DataList 提供できます。
DataList コントロールの外観のカスタマイズ
コントロールの DataList 外観は、コントロールのさまざまな部分のスタイル プロパティを設定することによってカスタマイズできます。 次の表に、さまざまなスタイル プロパティの一覧を示します。
| Style プロパティ | [説明] |
|---|---|
| AlternatingItemStyle | コントロール内の交互の項目のスタイルを DataList 指定します。 |
| EditItemStyle | コントロールで編集するアイテムのスタイルを DataList 指定します。 |
| FooterStyle | コントロールのフッターのスタイルを DataList 指定します。 |
| HeaderStyle | コントロール内のヘッダーのスタイルを DataList 指定します。 |
| ItemStyle | コントロール内の項目のスタイルを DataList 指定します。 |
| SelectedItemStyle | コントロールで選択した項目のスタイルを DataList 指定します。 |
| SeparatorStyle | コントロール内の項目間の区切り記号のスタイルを DataList 指定します。 |
コントロールのさまざまな部分を表示または非表示にすることもできます。 次の表は、表示または非表示の部分を制御するプロパティの一覧です。
| プロパティ | 説明 |
|---|---|
| ShowFooter | コントロールのフッター セクション DataList を表示または非表示にします。 |
| ShowHeader | コントロールのヘッダー セクション DataList を表示または非表示にします。 |
表示方向とレイアウト
コントロールの DataList 表示方向は、垂直または水平にすることができます。 プロパティを RepeatDirection 設定して、表示方向を指定します。
コントロールの DataList レイアウトは、 プロパティを使用して RepeatLayout 制御されます。 このプロパティを に RepeatLayout.Table 設定すると、 DataList はテーブル形式で表示され RepeatLayout.Flow 、 はテーブル構造なしで表示されます DataList 。
セキュリティ
コントロールには DataList 、ユーザーが情報を入力できるようにするコントロールを含めることができます。
注意事項
このコントロールは、悪意のあるクライアント スクリプトを含む可能性があるユーザー入力を表示するために使用できます。 クライアントから送信された情報で、実行可能スクリプト、SQL ステートメント、またはその他のコードを確認してから、アプリケーションに表示します。 入力コントロールを使用して、コントロールに入力テキストを表示する前にユーザー入力を確認できます。 ASP.NET は、ユーザー入力のスクリプトと HTML をブロックする入力要求検証機能を提供します。
セキュリティの詳細については、「 標準コントロールのセキュリティ保護」、「 方法: 文字列に HTML エンコードを適用して Web アプリケーションのスクリプトの悪用から保護する」、および「 ASP.NET Web ページでのユーザー入力の検証」を参照してください。
宣言構文
<asp:DataList
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
Caption="string"
CaptionAlign="NotSet|Top|Bottom|Left|Right"
CellPadding="integer"
CellSpacing="integer"
CssClass="string"
DataKeyField="string"
DataMember="string"
DataSource="string"
DataSourceID="string"
EditItemIndex="integer"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
ExtractTemplateRows="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
GridLines="None|Horizontal|Vertical|Both"
Height="size"
HorizontalAlign="NotSet|Left|Center|Right|Justify"
ID="string"
OnCancelCommand="CancelCommand event handler"
OnDataBinding="DataBinding event handler"
OnDeleteCommand="DeleteCommand event handler"
OnDisposed="Disposed event handler"
OnEditCommand="EditCommand event handler"
OnInit="Init event handler"
OnItemCommand="ItemCommand event handler"
OnItemCreated="ItemCreated event handler"
OnItemDataBound="ItemDataBound event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnSelectedIndexChanged="SelectedIndexChanged event handler"
OnUnload="Unload event handler"
OnUpdateCommand="UpdateCommand event handler"
RepeatColumns="integer"
RepeatDirection="Horizontal|Vertical"
RepeatLayout="Table|Flow"
runat="server"
SelectedIndex="integer"
ShowFooter="True|False"
ShowHeader="True|False"
SkinID="string"
Style="string"
TabIndex="integer"
ToolTip="string"
UseAccessibleHeader="True|False"
Visible="True|False"
Width="size"
>
<AlternatingItemStyle />
<AlternatingItemTemplate>
<!-- child controls -->
</AlternatingItemTemplate>
<EditItemStyle />
<EditItemTemplate>
<!-- child controls -->
</EditItemTemplate>
<FooterStyle />
<FooterTemplate>
<!-- child controls -->
</FooterTemplate>
<HeaderStyle />
<HeaderTemplate>
<!-- child controls -->
</HeaderTemplate>
<ItemStyle />
<ItemTemplate>
<!-- child controls -->
</ItemTemplate>
<SelectedItemStyle />
<SelectedItemTemplate>
<!-- child controls -->
</SelectedItemTemplate>
<SeparatorStyle />
<SeparatorTemplate>
<!-- child controls -->
</SeparatorTemplate>
</asp:DataList>
コンストラクター
| DataList() |
DataList クラスの新しいインスタンスを初期化します。 |
フィールド
| CancelCommandName |
|
| DeleteCommandName |
|
| EditCommandName |
|
| SelectCommandName |
|
| UpdateCommandName |
|
プロパティ
| AccessKey |
Web サーバー コントロールにすばやく移動できるアクセス キーを取得または設定します。 (継承元 WebControl) |
| Adapter |
コントロール用のブラウザー固有のアダプターを取得します。 (継承元 Control) |
| AlternatingItemStyle |
DataList コントロールの交互の項目のスタイル プロパティを取得します。 |
| AlternatingItemTemplate |
DataList 内の交互の項目のテンプレートを取得または設定します。 |
| AppRelativeTemplateSourceDirectory |
このコントロールが含まれている Page オブジェクトまたは UserControl オブジェクトのアプリケーション相対の仮想ディレクトリを取得または設定します。 (継承元 Control) |
| Attributes |
コントロールのプロパティに対応しない任意の属性 (表示専用) のコレクションを取得します。 (継承元 WebControl) |
| BackColor |
Web サーバー コントロールの背景色を取得または設定します。 (継承元 WebControl) |
| BindingContainer |
このコントロールのデータ バインディングを格納しているコントロールを取得します。 (継承元 Control) |
| BorderColor |
Web コントロールの境界線の色を取得または設定します。 (継承元 WebControl) |
| BorderStyle |
Web サーバー コントロールの境界線スタイルを取得または設定します。 (継承元 WebControl) |
| BorderWidth |
Web サーバー コントロールの境界線の幅を取得または設定します。 (継承元 WebControl) |
| Caption |
コントロールの HTML キャプション要素に表示するテキストを取得または設定します。 このプロパティは、補助技術デバイスのユーザーにとって、より使いやすいコントロールを実現するための手段として用意されています。 (継承元 BaseDataList) |
| CaptionAlign |
コントロールの HTML キャプション要素の水平位置または垂直位置を取得または設定します。 このプロパティは、補助技術デバイスのユーザーにとって、より使いやすいコントロールを実現するための手段として用意されています。 (継承元 BaseDataList) |
| CellPadding |
セルの内容とセルの境界線との間隔を取得または設定します。 (継承元 BaseDataList) |
| CellSpacing |
セル間の間隔を取得または設定します。 (継承元 BaseDataList) |
| ChildControlsCreated |
サーバー コントロールの子コントロールが作成されたかどうかを示す値を取得します。 (継承元 Control) |
| ClientID |
ASP.NET によって生成される HTML マークアップのコントロール ID を取得します。 (継承元 Control) |
| ClientIDMode |
ClientID プロパティの値を生成するために使用されるアルゴリズムを取得または設定します。 (継承元 Control) |
| ClientIDSeparator |
ClientID プロパティで使用される区切り記号を表す文字値を取得します。 (継承元 Control) |
| Context |
現在の Web 要求に対するサーバー コントロールに関連付けられている HttpContext オブジェクトを取得します。 (継承元 Control) |
| Controls |
データ リスト コントロールの子コントロールのコレクションを格納している ControlCollection オブジェクトを取得します。 (継承元 BaseDataList) |
| ControlStyle |
Web サーバー コントロールのスタイルを取得します。 このプロパティは、主にコントロールの開発者によって使用されます。 (継承元 WebControl) |
| ControlStyleCreated |
Style オブジェクトが ControlStyle プロパティに対して作成されたかどうかを示す値を取得します。 このプロパティは、主にコントロールの開発者によって使用されます。 (継承元 WebControl) |
| CssClass |
クライアントで Web サーバー コントロールによって表示されるカスケード スタイル シート (CSS: Cascading Style Sheet) クラスを取得または設定します。 (継承元 WebControl) |
| DataItemContainer |
名前付けコンテナーが IDataItemContainer を実装している場合、名前付けコンテナーへの参照を取得します。 (継承元 Control) |
| DataKeyField |
DataSource プロパティで指定したデータ ソースのキー フィールドを取得または設定します。 (継承元 BaseDataList) |
| DataKeys |
データ リスト コントロールの各レコードのキー値を格納する DataKeyCollection オブジェクトを取得します。 (継承元 BaseDataList) |
| DataKeysArray |
データ リスト コントロールの各レコードのキー値を格納する ArrayList オブジェクトを取得します。 (継承元 BaseDataList) |
| DataKeysContainer |
名前付けコンテナーが IDataKeysControl を実装している場合、名前付けコンテナーへの参照を取得します。 (継承元 Control) |
| DataMember |
データ リスト コントロールに連結する複数メンバー データ ソースの特定のデータ メンバーを取得または設定します。 (継承元 BaseDataList) |
| DataSource |
コントロール内に項目を設定するために使用する値のリストを格納しているソースを取得または設定します。 (継承元 BaseDataList) |
| DataSourceID |
データ リスト コントロールがデータ ソースを取得するために使用する、データ ソース コントロールの ID プロパティを取得または設定します。 (継承元 BaseDataList) |
| DesignMode |
コントロールがデザイン サーフェイスで使用されているかどうかを示す値を取得します。 (継承元 Control) |
| EditItemIndex |
DataList コントロール内の編集対象として選択された項目のインデックス番号を取得または設定します。 |
| EditItemStyle |
DataList コントロールの編集対象として選択された項目のスタイル プロパティを取得します。 |
| EditItemTemplate |
DataList コントロール内の編集対象として選択された項目のテンプレートを取得または設定します。 |
| Enabled |
Web サーバー コントロールを有効にするかどうかを示す値を取得または設定します。 (継承元 WebControl) |
| EnableTheming |
テーマがこのコントロールに適用されるかどうかを示す値を取得または設定します。 (継承元 WebControl) |
| EnableViewState |
要求元クライアントに対して、サーバー コントロールがそのビュー状態と、そこに含まれる任意の子のコントロールのビュー状態を保持するかどうかを示す値を取得または設定します。 (継承元 Control) |
| Events |
コントロールのイベント ハンドラー デリゲートのリストを取得します。 このプロパティは読み取り専用です。 (継承元 Control) |
| ExtractTemplateRows |
Table コントロールの各テンプレート内で定義された DataList コントロールの行を抽出して表示するかどうかを示す値を取得または設定します。 |
| Font |
Web サーバー コントロールに関連付けられたフォント プロパティを取得します。 (継承元 WebControl) |
| FooterStyle |
DataList コントロールのフッター セクションのスタイル プロパティを取得します。 |
| FooterTemplate |
DataList コントロールのフッター セクションのテンプレートを取得または設定します。 |
| ForeColor |
Web サーバー コントロールの前景色 (通常はテキストの色) を取得または設定します。 (継承元 WebControl) |
| GridLines |
DataList プロパティが |
| HasAttributes |
コントロールに属性セットがあるかどうかを示す値を取得します。 (継承元 WebControl) |
| HasChildViewState |
現在のサーバー コントロールの子コントロールが、保存されたビューステートの設定を持っているかどうかを示す値を取得します。 (継承元 Control) |
| HeaderStyle |
DataList コントロールの見出しセクションのスタイル プロパティを取得します。 |
| HeaderTemplate |
DataList コントロールの見出しセクションのテンプレートを取得または設定します。 |
| Height |
Web サーバー コントロールの高さを取得または設定します。 (継承元 WebControl) |
| HorizontalAlign |
コンテナー内のデータ リスト コントロールの水平方向の配置を取得または設定します。 (継承元 BaseDataList) |
| ID |
サーバー コントロールに割り当てられたプログラム ID を取得または設定します。 (継承元 Control) |
| IdSeparator |
コントロール ID を区別するために使用する文字を取得します。 (継承元 Control) |
| Initialized |
コントロールが初期化されているかどうか示す値を取得します。 (継承元 BaseDataList) |
| IsBoundUsingDataSourceID |
DataSourceID プロパティが設定されているかどうかを示す値を取得します。 (継承元 BaseDataList) |
| IsChildControlStateCleared |
このコントロールに含まれているコントロールに、コントロールの状態が設定されているかどうかを示す値を取得します。 (継承元 Control) |
| IsEnabled |
コントロールが有効かどうかを示す値を取得します。 (継承元 WebControl) |
| IsTrackingViewState |
サーバー コントロールがビューステートの変更を保存しているかどうかを示す値を取得します。 (継承元 Control) |
| IsViewStateEnabled |
このコントロールでビューステートが有効かどうかを示す値を取得します。 (継承元 Control) |
| Items |
コントロール内の個別の項目を表す DataListItem オブジェクトのコレクションを取得します。 |
| ItemStyle |
DataList コントロールの項目のスタイル プロパティを取得します。 |
| ItemTemplate |
DataList コントロールの項目のテンプレートを取得または設定します。 |
| LoadViewStateByID |
コントロールがインデックスではなく ID によりビューステートの読み込みを行うかどうかを示す値を取得します。 (継承元 Control) |
| NamingContainer |
同じ ID プロパティ値を持つ複数のサーバー コントロールを区別するための一意の名前空間を作成する、サーバー コントロールの名前付けコンテナーへの参照を取得します。 (継承元 Control) |
| Page |
サーバー コントロールを含んでいる Page インスタンスへの参照を取得します。 (継承元 Control) |
| Parent |
ページ コントロールの階層構造における、サーバー コントロールの親コントロールへの参照を取得します。 (継承元 Control) |
| RenderingCompatibility |
レンダリングされる HTML と互換性がある ASP.NET のバージョンを表す値を取得します。 (継承元 Control) |
| RepeatColumns |
DataList コントロールに表示する列数を取得または設定します。 |
| RepeatDirection |
DataList コントロールを水平または垂直のどちらで表示するかを取得または設定します。 |
| RepeatLayout |
コントロールをテーブル レイアウトまたはフロー レイアウトのどちらで表示するかを取得または設定します。 |
| RequiresDataBinding |
データ リスト コントロールを指定したデータ ソースにバインドする必要があるかどうか示す値を取得または設定します。 (継承元 BaseDataList) |
| SelectArguments |
データ バインド コントロールが、データ ソース コントロールからデータを取得するときに使用する DataSourceSelectArguments オブジェクトを取得します。 (継承元 BaseDataList) |
| SelectedIndex |
DataList コントロール内の選択された項目のインデックスを取得または設定します。 |
| SelectedItem |
DataList コントロール内の選択された項目を取得します。 |
| SelectedItemStyle |
DataList コントロール内の選択された項目のスタイル プロパティを取得します。 |
| SelectedItemTemplate |
DataList コントロール内の選択された項目のテンプレートを取得または設定します。 |
| SelectedValue |
選択されたデータ リスト項目のキー フィールドの値を取得します。 |
| SeparatorStyle |
DataList コントロールの各項目間の区切り記号のスタイル プロパティを取得します。 |
| SeparatorTemplate |
DataList コントロールの項目間の区切り記号のテンプレートを取得または設定します。 |
| ShowFooter |
DataList コントロールにフッター セクションを表示するかどうかを示す値を取得または設定します。 |
| ShowHeader |
DataList コントロールにヘッダー セクションを表示するかどうかを示す値を取得または設定します。 |
| Site |
デザイン サーフェイスに現在のコントロールを表示するときに、このコントロールをホストするコンテナーに関する情報を取得します。 (継承元 Control) |
| SkinID |
コントロールに適用するスキンを取得または設定します。 (継承元 WebControl) |
| Style |
Web サーバー コントロールの外側のタグにスタイル属性として表示されるテキスト属性のコレクションを取得します。 (継承元 WebControl) |
| SupportsDisabledAttribute |
コントロールの |
| TabIndex |
Web サーバー コントロールのタブ インデックスを取得または設定します。 (継承元 WebControl) |
| TagKey |
DataList コントロールを表示するために使用する HTML タグを取得します。 |
| TagKey |
この Web サーバー コントロールに対応する HtmlTextWriterTag 値を取得します。 このプロパティは、主にコントロールの開発者によって使用されます。 (継承元 WebControl) |
| TagName |
コントロール タグの名前を取得します。 このプロパティは、主にコントロールの開発者によって使用されます。 (継承元 WebControl) |
| TemplateControl |
このコントロールを格納しているテンプレートへの参照を取得または設定します。 (継承元 Control) |
| TemplateSourceDirectory |
現在のサーバー コントロールを格納している Page または UserControl の仮想ディレクトリを取得します。 (継承元 Control) |
| ToolTip |
マウス ポインターが Web サーバー コントロールの上を移動したときに表示されるテキストを取得または設定します。 (継承元 WebControl) |
| UniqueID |
階層構造で修飾されたサーバー コントロールの一意の ID を取得します。 (継承元 Control) |
| UseAccessibleHeader |
データ リスト コントロールのヘッダーをユーザー補助対応の形式で表示するかどうか示す値を取得または設定します。 このプロパティは、補助技術デバイスのユーザーにとって、より使いやすいコントロールを実現するための手段として用意されています。 (継承元 BaseDataList) |
| ValidateRequestMode |
ブラウザーからのクライアント入力の安全性をコントロールで調べるかどうかを示す値を取得または設定します。 (継承元 Control) |
| ViewState |
同一のページに対する複数の要求にわたって、サーバー コントロールのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。 (継承元 Control) |
| ViewStateIgnoresCase |
StateBag オブジェクトが大文字小文字を区別しないかどうかを示す値を取得します。 (継承元 Control) |
| ViewStateMode |
このコントロールのビューステート モードを取得または設定します。 (継承元 Control) |
| Visible |
サーバー コントロールがページ上の UI としてレンダリングされているかどうかを示す値を取得または設定します。 (継承元 Control) |
| Width |
Web サーバー コントロールの幅を取得または設定します。 (継承元 WebControl) |
メソッド
| AddAttributesToRender(HtmlTextWriter) |
指定した HtmlTextWriterTag に表示する必要のある HTML 属性およびスタイルを追加します。 このメソッドは、主にコントロールの開発者によって使用されます。 (継承元 WebControl) |
| AddedControl(Control, Int32) |
子コントロールが Control オブジェクトの Controls コレクションに追加された後に呼び出されます。 (継承元 Control) |
| AddParsedSubObject(Object) |
サーバー コントロールに、XML または HTML の要素が解析されたことを通知し、その要素をサーバー コントロールの ControlCollection コレクションに追加します。 (継承元 BaseDataList) |
| ApplyStyle(Style) |
指定したスタイルの空白以外の要素を Web コントロールにコピーして、コントロールの既存のスタイル要素を上書きします。 このメソッドは、主にコントロールの開発者によって使用されます。 (継承元 WebControl) |
| ApplyStyleSheetSkin(Page) |
ページのスタイル シートに定義されたスタイル プロパティをコントロールに適用します。 (継承元 Control) |
| BeginRenderTracing(TextWriter, Object) |
レンダリング データのデザイン時のトレースを開始します。 (継承元 Control) |
| BuildProfileTree(String, Boolean) |
ページのトレースが有効な場合、サーバー コントロールに関する情報を収集し、これを表示するために Trace プロパティに渡します。 (継承元 Control) |
| ClearCachedClientID() |
キャッシュされた ClientID 値を |
| ClearChildControlState() |
サーバー コントロールのすべての子コントロールについて、コントロールの状態情報を削除します。 (継承元 Control) |
| ClearChildState() |
サーバー コントロールのすべての子コントロールのビューステート情報およびコントロールの状態情報を削除します。 (継承元 Control) |
| ClearChildViewState() |
サーバー コントロールのすべての子コントロールのビューステート情報を削除します。 (継承元 Control) |
| ClearEffectiveClientIDMode() |
現在のコントロール インスタンスおよびすべての子コントロールの ClientIDMode プロパティを Inherit に設定します。 (継承元 Control) |
| CopyBaseAttributes(WebControl) |
指定した Web サーバー コントロールから、Style オブジェクトでカプセル化されていないプロパティをこのメソッドの呼び出し元の Web サーバー コントロールにコピーします。 このメソッドは、主にコントロールの開発者によって使用されます。 (継承元 WebControl) |
| CreateChildControls() |
ビューステートを使用して子コントロールを作成します。 (継承元 BaseDataList) |
| CreateControlCollection() |
サーバー コントロールの子コントロール (リテラルとサーバーの両方) を保持する新しい ControlCollection オブジェクトを作成します。 (継承元 Control) |
| CreateControlHierarchy(Boolean) |
指定されたデータ ソースを使用するかしないかにかかわらず、データ リスト コントロールを表示するために使用されるコントロール階層を作成します。 |
| CreateControlStyle() |
すべてのスタイル関連プロパティを実装するために DataList コントロールが内部で使用する既定のスタイル オブジェクトを作成します。 |
| CreateDataSourceSelectArguments() |
引数が指定されていない場合にデータ バインド コントロールが使用する、既定の DataSourceSelectArguments オブジェクトを作成します。 (継承元 BaseDataList) |
| CreateItem(Int32, ListItemType) |
DataListItem オブジェクトを作成します。 |
| DataBind() |
指定されたデータ ソースにコントロールとそのすべての子コントロールをバインドします。 (継承元 BaseDataList) |
| DataBind(Boolean) |
DataBinding イベントを発生させるオプションを指定して、呼び出されたサーバー コントロールとそのすべての子コントロールにデータ ソースをバインドします。 (継承元 Control) |
| DataBindChildren() |
データ ソースをサーバー コントロールの子コントロールにバインドします。 (継承元 Control) |
| Dispose() |
サーバー コントロールが、メモリから解放される前に最終的なクリーンアップを実行できるようにします。 (継承元 Control) |
| EndRenderTracing(TextWriter, Object) |
レンダリング データのデザイン時のトレースを終了します。 (継承元 Control) |
| EnsureChildControls() |
サーバー コントロールに子コントロールが含まれているかどうかを確認します。 含まれていない場合、子コントロールを作成します。 (継承元 Control) |
| EnsureDataBound() |
データ リスト コントロールにデータ バインディングが必要かどうか、および有効なデータ ソース コントロールが指定されているどうかを、DataBind() メソッドを呼び出す前に確認します。 (継承元 BaseDataList) |
| EnsureID() |
ID が割り当てられていないコントロールの ID を作成します。 (継承元 Control) |
| Equals(Object) |
指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
| FindControl(String) |
指定した |
| FindControl(String, Int32) |
指定した |
| Focus() |
コントロールに入力フォーカスを設定します。 (継承元 Control) |
| GetData() |
データ ソースを表す IEnumerable 実装オブジェクトを返します。 (継承元 BaseDataList) |
| GetDesignModeState() |
コントロールのデザイン時データを取得します。 (継承元 Control) |
| GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
| GetRouteUrl(Object) |
ルート パラメーターのセットに対応する URL を取得します。 (継承元 Control) |
| GetRouteUrl(RouteValueDictionary) |
ルート パラメーターのセットに対応する URL を取得します。 (継承元 Control) |
| GetRouteUrl(String, Object) |
ルート パラメーターのセットおよびルート名に対応する URL を取得します。 (継承元 Control) |
| GetRouteUrl(String, RouteValueDictionary) |
ルート パラメーターのセットおよびルート名に対応する URL を取得します。 (継承元 Control) |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| GetUniqueIDRelativeTo(Control) |
指定されたコントロールの UniqueID プロパティのプレフィックス部分を返します。 (継承元 Control) |
| HasControls() |
サーバー コントロールに子コントロールが含まれているかどうかを確認します。 (継承元 Control) |
| HasEvents() |
コントロールまたは子コントロールに対してイベントが登録されているかどうかを示す値を返します。 (継承元 Control) |
| InitializeItem(DataListItem) |
リスト項目の型に対して指定したテンプレートおよびスタイルに基づいて、DataListItem オブジェクトを初期化します。 |
| IsLiteralContent() |
サーバー コントロールがリテラルな内容だけを保持しているかどうかを決定します。 (継承元 Control) |
| LoadControlState(Object) |
SaveControlState() メソッドによって保存された前回のページ要求からコントロールの状態情報を復元します。 (継承元 Control) |
| LoadViewState(Object) |
以前に保存した DataList コントロールのビュー ステートを読み込みます。 |
| MapPathSecure(String) |
仮想パス (絶対パスまたは相対パス) の割り当て先の物理パスを取得します。 (継承元 Control) |
| MemberwiseClone() |
現在の Object の簡易コピーを作成します。 (継承元 Object) |
| MergeStyle(Style) |
指定したスタイルの空白以外の要素を Web コントロールにコピーしますが、コントロールの既存のスタイル要素は上書きしません。 このメソッドは、主にコントロールの開発者によって使用されます。 (継承元 WebControl) |
| OnBubbleEvent(Object, EventArgs) |
サーバー コントロールのイベントをページの UI サーバー コントロールの階層構造に渡すかどうかを決定します。 |
| OnCancelCommand(DataListCommandEventArgs) |
CancelCommand イベントを発生させます。 これにより、イベントのカスタム ハンドラーを作成できます。 |
| OnDataBinding(EventArgs) |
DataBinding コントロールの BaseDataList イベントを発生させます。 (継承元 BaseDataList) |
| OnDataPropertyChanged() |
基本データ ソースの識別プロパティが変更された場合に、データ バインド コントロールをデータに再バインドするために呼び出されます。 (継承元 BaseDataList) |
| OnDataSourceViewChanged(Object, EventArgs) |
DataSourceViewChanged イベントを発生させます。 (継承元 BaseDataList) |
| OnDeleteCommand(DataListCommandEventArgs) |
DeleteCommand イベントを発生させます。 これにより、イベントのカスタム ハンドラーを作成できます。 |
| OnEditCommand(DataListCommandEventArgs) |
EditCommand イベントを発生させます。 これにより、イベントのカスタム ハンドラーを作成できます。 |
| OnInit(EventArgs) | |
| OnInit(EventArgs) |
BaseDataList コントロールの Init イベントを発生させます。 (継承元 BaseDataList) |
| OnItemCommand(DataListCommandEventArgs) |
ItemCommand イベントを発生させます。 これにより、イベントのカスタム ハンドラーを作成できます。 |
| OnItemCreated(DataListItemEventArgs) |
ItemCreated イベントを発生させます。 これにより、イベントのカスタム ハンドラーを作成できます。 |
| OnItemDataBound(DataListItemEventArgs) |
ItemDataBound イベントを発生させます。 これにより、イベントのカスタム ハンドラーを作成できます。 |
| OnLoad(EventArgs) |
Load イベントを発生させます。 (継承元 BaseDataList) |
| OnPreRender(EventArgs) |
PreRender イベントを発生させます。 (継承元 BaseDataList) |
| OnSelectedIndexChanged(EventArgs) |
SelectedIndexChanged コントロールの BaseDataList イベントを発生させます。 (継承元 BaseDataList) |
| OnUnload(EventArgs) |
Unload イベントを発生させます。 (継承元 Control) |
| OnUpdateCommand(DataListCommandEventArgs) |
UpdateCommand イベントを発生させます。 これにより、イベントのカスタム ハンドラーを作成できます。 |
| OpenFile(String) |
ファイルの読み込みで使用される Stream を取得します。 (継承元 Control) |
| PrepareControlHierarchy() |
DataList コントロールに表示するコントロール階層を準備します。 |
| RaiseBubbleEvent(Object, EventArgs) |
イベントのソースおよびその情報をコントロールの親に割り当てます。 (継承元 Control) |
| RemovedControl(Control) |
Control オブジェクトの Controls コレクションから子コントロールが削除された後に呼び出されます。 (継承元 Control) |
| Render(HtmlTextWriter) |
指定された HTML ライターにコントロールを描画します。 (継承元 BaseDataList) |
| RenderBeginTag(HtmlTextWriter) |
コントロールの HTML 開始タグを指定したライターに表示します。 このメソッドは、主にコントロールの開発者によって使用されます。 (継承元 WebControl) |
| RenderChildren(HtmlTextWriter) |
提供された HtmlTextWriter オブジェクトに対してサーバー コントロールの子のコンテンツを出力すると、クライアントで表示されるコンテンツが記述されます。 (継承元 Control) |
| RenderContents(HtmlTextWriter) |
DataList コントロール内のリスト項目を表示します。 |
| RenderControl(HtmlTextWriter) |
指定の HtmlTextWriter オブジェクトにサーバー コントロールの内容を出力し、トレースが有効である場合はコントロールに関するトレース情報を保存します。 (継承元 Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
指定した ControlAdapter オブジェクトを使用して、指定した HtmlTextWriter オブジェクトにサーバー コントロールの内容を出力します。 (継承元 Control) |
| RenderEndTag(HtmlTextWriter) |
コントロールの HTML 終了タグを指定したライターに表示します。 このメソッドは、主にコントロールの開発者によって使用されます。 (継承元 WebControl) |
| ResolveAdapter() |
指定したコントロールを表示するコントロール アダプターを取得します。 (継承元 Control) |
| ResolveClientUrl(String) |
ブラウザーで使用できる URL を取得します。 (継承元 Control) |
| ResolveUrl(String) |
要求側クライアントで使用できる URL に変換します。 (継承元 Control) |
| SaveControlState() |
ページがサーバーにポスト バックされた時間以降に発生したすべてのサーバー コントロール状態の変化を保存します。 (継承元 Control) |
| SaveViewState() |
ページがサーバーにポスト バックされた時間以降に発生した、コントロールのビューステートへの変更を保存します。 |
| SetDesignModeState(IDictionary) |
コントロールのデザイン時データを設定します。 (継承元 Control) |
| SetRenderMethodDelegate(RenderMethod) |
サーバー コントロールとその内容を親コントロールに表示するイベント ハンドラー デリゲートを割り当てます。 (継承元 Control) |
| SetTraceData(Object, Object) |
トレース データ キーとトレース データ値を使用して、レンダリング データのデザイン時トレースのトレース データを設定します。 (継承元 Control) |
| SetTraceData(Object, Object, Object) |
トレースされたオブジェクト、トレース データ キー、およびトレース データ値を使用して、レンダリング データのデザイン時トレースのトレース データを設定します。 (継承元 Control) |
| ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
| TrackViewState() |
DataList コントロールに対するビューステートの変更を追跡し、コントロールの ViewState プロパティに保存できるようにします。 |
イベント
| CancelCommand |
DataList コントロールの項目に対して |
| DataBinding |
サーバー コントロールがデータ ソースに連結すると発生します。 (継承元 Control) |
| DeleteCommand |
DataList コントロールの項目に対して |
| Disposed |
サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。 (継承元 Control) |
| EditCommand |
DataList コントロールの項目に対して |
| Init |
サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。 (継承元 Control) |
| ItemCommand |
DataList コントロールの任意のボタンがクリックされたときに発生します。 |
| ItemCreated |
DataList コントロールに項目が作成されたときにサーバーで発生します。 |
| ItemDataBound |
項目が DataList コントロールにデータ連結されたときに発生します。 |
| Load |
サーバー コントロールが Page オブジェクトに読み込まれると発生します。 (継承元 Control) |
| PreRender |
Control オブジェクトの読み込み後、表示を開始する前に発生します。 (継承元 Control) |
| SelectedIndexChanged |
サーバーへのポスト間でデータ リスト コントロールの別の項目が選択されると発生します。 (継承元 BaseDataList) |
| Unload |
サーバー コントロールがメモリからアンロードされると発生します。 (継承元 Control) |
| UpdateCommand |
DataList コントロールの項目に対して |
明示的なインターフェイスの実装
拡張メソッド
| FindDataSourceControl(Control) |
指定されたコントロールのデータ コントロールに関連付けられているデータ ソースを返します。 |
| FindFieldTemplate(Control, String) |
指定されたコントロールの名前付けコンテナー内にある、指定された列のフィールド テンプレートを返します。 |
| FindMetaTable(Control) |
格納しているデータ コントロールのメタテーブル オブジェクトを返します。 |
| GetDefaultValues(INamingContainer) |
指定されたデータ コントロールの既定値のコレクションを取得します。 |
| GetMetaTable(INamingContainer) |
指定されたデータ コントロールのテーブル メタデータを取得します。 |
| SetMetaTable(INamingContainer, MetaTable) |
指定されたデータ コントロールのテーブル メタデータを設定します。 |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
指定したデータ コントロールのテーブル メタデータおよび既定値のマッピングを設定します。 |
| SetMetaTable(INamingContainer, MetaTable, Object) |
指定したデータ コントロールのテーブル メタデータおよび既定値のマッピングを設定します。 |
| TryGetMetaTable(INamingContainer, MetaTable) |
テーブル メタデータが使用できるかどうかを判断します。 |
| EnableDynamicData(INamingContainer, Type) |
指定されたデータ コントロールの動的データの動作を有効にします。 |
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
指定されたデータ コントロールの動的データの動作を有効にします。 |
| EnableDynamicData(INamingContainer, Type, Object) |
指定されたデータ コントロールの動的データの動作を有効にします。 |