DataList クラス

定義

テンプレートを使用して項目を表示するデータ連結リスト コントロール。

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 してデータ ソースの項目の一覧を表示する方法を示します。

Note

次のコード サンプルでは、単一ファイル コード モデルを使用しており、分離コード ファイルに直接コピーすると正しく動作しない場合があります。 このコード サンプルは、拡張子が .aspx の空のテキスト ファイルにコピーする必要があります。 Web Forms コード モデルの詳細については、「ASP.NET Web Forms ページ コード モデル」を参照してください。


<%@ 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

Cancel コマンド名を表します。 このフィールドは読み取り専用です。

DeleteCommandName

Delete コマンド名を表します。 このフィールドは読み取り専用です。

EditCommandName

Edit コマンド名を表します。 このフィールドは読み取り専用です。

SelectCommandName

Select コマンド名を表します。 このフィールドは読み取り専用です。

UpdateCommandName

Update コマンド名を表します。 このフィールドは読み取り専用です。

プロパティ

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 プロパティが RepeatLayout.Table に設定されているときの RepeatLayout コントロールのグリッド線スタイルを取得または設定します。

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

コントロールの disabled プロパティが IsEnabled の場合、レンダリングされた HTML 要素の false 属性を "無効" に設定するかどうかを示す値を取得します。

(継承元 BaseDataList)
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 値を null に設定します。

(継承元 Control)
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)

指定した id パラメーターを使用して、サーバー コントロールの現在の名前付けコンテナーを検索します。

(継承元 Control)
FindControl(String, Int32)

指定した id および検索に役立つ pathOffset パラメーターに指定された整数を使用して、サーバー コントロールの現在の名前付けコンテナーを検索します。 この形式の FindControl メソッドはオーバーライドしないでください。

(継承元 Control)
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)

DataList コントロールの Init イベントを発生させます。

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 コントロールの項目に対して Cancel ボタンがクリックされたときに発生します。

DataBinding

サーバー コントロールがデータ ソースに連結すると発生します。

(継承元 Control)
DeleteCommand

DataList コントロールの項目に対して Delete ボタンがクリックされたときに発生します。

Disposed

サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。

(継承元 Control)
EditCommand

DataList コントロールの項目に対して Edit ボタンがクリックされたときに発生します。

Init

サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。

(継承元 Control)
ItemCommand

DataList コントロールの任意のボタンがクリックされたときに発生します。

ItemCreated

DataList コントロールに項目が作成されたときにサーバーで発生します。

ItemDataBound

項目が DataList コントロールにデータ連結されたときに発生します。

Load

サーバー コントロールが Page オブジェクトに読み込まれると発生します。

(継承元 Control)
PreRender

Control オブジェクトの読み込み後、表示を開始する前に発生します。

(継承元 Control)
SelectedIndexChanged

サーバーへのポスト間でデータ リスト コントロールの別の項目が選択されると発生します。

(継承元 BaseDataList)
Unload

サーバー コントロールがメモリからアンロードされると発生します。

(継承元 Control)
UpdateCommand

DataList コントロールの項目に対して Update ボタンがクリックされたときに発生します。

明示的なインターフェイスの実装

IAttributeAccessor.GetAttribute(String)

指定された名前の Web コントロールの属性を取得します。

(継承元 WebControl)
IAttributeAccessor.SetAttribute(String, String)

Web コントロールの属性を指定された名前と値に設定します。

(継承元 WebControl)
IControlBuilderAccessor.ControlBuilder

このメンバーの詳細については、「ControlBuilder」をご覧ください。

(継承元 Control)
IControlDesignerAccessor.GetDesignModeState()

このメンバーの詳細については、「GetDesignModeState()」をご覧ください。

(継承元 Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

このメンバーの詳細については、「SetDesignModeState(IDictionary)」をご覧ください。

(継承元 Control)
IControlDesignerAccessor.SetOwnerControl(Control)

このメンバーの詳細については、「SetOwnerControl(Control)」をご覧ください。

(継承元 Control)
IControlDesignerAccessor.UserData

このメンバーの詳細については、「UserData」をご覧ください。

(継承元 Control)
IDataBindingsAccessor.DataBindings

このメンバーの詳細については、「DataBindings」をご覧ください。

(継承元 Control)
IDataBindingsAccessor.HasDataBindings

このメンバーの詳細については、「HasDataBindings」をご覧ください。

(継承元 Control)
IExpressionsAccessor.Expressions

このメンバーの詳細については、「Expressions」をご覧ください。

(継承元 Control)
IExpressionsAccessor.HasExpressions

このメンバーの詳細については、「HasExpressions」をご覧ください。

(継承元 Control)
IParserAccessor.AddParsedSubObject(Object)

このメンバーの詳細については、「AddParsedSubObject(Object)」をご覧ください。

(継承元 Control)
IRepeatInfoUser.GetItemStyle(ListItemType, Int32)

このメンバーの詳細については、「GetItemStyle(ListItemType, Int32)」をご覧ください。

IRepeatInfoUser.HasFooter

このメンバーの詳細については、「HasFooter」をご覧ください。

IRepeatInfoUser.HasHeader

このメンバーの詳細については、「HasHeader」をご覧ください。

IRepeatInfoUser.HasSeparators

このメンバーの詳細については、「HasSeparators」をご覧ください。

IRepeatInfoUser.RenderItem(ListItemType, Int32, RepeatInfo, HtmlTextWriter)

このメンバーの詳細については、「RenderItem(ListItemType, Int32, RepeatInfo, HtmlTextWriter)」をご覧ください。

IRepeatInfoUser.RepeatedItemCount

このメンバーの詳細については、「RepeatedItemCount」をご覧ください。

拡張メソッド

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)

指定されたデータ コントロールの動的データの動作を有効にします。

適用対象

こちらもご覧ください