DataList 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
使用範本顯示項目的資料繫結清單控制項。
public ref class DataList : System::Web::UI::WebControls::BaseDataList, System::Web::UI::INamingContainer, System::Web::UI::WebControls::IRepeatInfoUserpublic 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.IRepeatInfoUsertype DataList = class
inherit BaseDataList
interface INamingContainer
interface IRepeatInfoUser[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type DataList = class
inherit BaseDataList
interface INamingContainer
interface IRepeatInfoUserPublic Class DataList
Inherits BaseDataList
Implements INamingContainer, IRepeatInfoUser- 繼承
- 屬性
- 實作
範例
下列程式代碼範例示範如何使用 DataList 控件來顯示數據源中的專案清單。
注意
下列程式代碼範例會使用單一檔案程式代碼模型，如果直接複製到程式代碼後置檔案，可能無法正常運作。 此程式代碼範例必須複製到擴展名為 .aspx的空文本檔。 如需 Web Forms 程式代碼模型的詳細資訊，請參閱 ASP.NET 網頁代碼模型。
<%@ 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 網頁中驗證使用者輸入。
宣告式語法
<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 |
取得或設定便捷鍵 (Access Key)，可讓您快速巡覽至 Web 伺服器控制項。 (繼承來源 WebControl) |
| Adapter |
針對控制項取得瀏覽器的特定配置器。 (繼承來源 Control) |
| AlternatingItemStyle |
取得 DataList 控制項中替代項目的樣式屬性。 |
| AlternatingItemTemplate |
取得或設定 DataList 中替代項目的樣板。 |
| AppRelativeTemplateSourceDirectory |
取得或設定包含了此控制項之 Page 或 UserControl 物件的相對應用程式虛擬目錄。 (繼承來源 Control) |
| Attributes |
取得任意屬性 (Attribute) 的集合 (只供呈現)，不與控制項上的屬性 (Property) 對應。 (繼承來源 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 標記的控制項識別碼。 (繼承來源 Control) |
| ClientIDMode |
取得或設定用來產生 ClientID 屬性值的演算法。 (繼承來源 Control) |
| ClientIDSeparator |
取得字元值，表示在 ClientID 屬性中所使用的分隔字元。 (繼承來源 Control) |
| Context |
取得與目前 Web 要求的伺服器控制項關聯的 HttpContext 物件。 (繼承來源 Control) |
| Controls |
取得 ControlCollection 物件，其包含資料清單控制項內子控制項的集合。 (繼承來源 BaseDataList) |
| ControlStyle |
取得 Web 伺服器控制項的樣式。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
| ControlStyleCreated |
取得值，指出 Style 物件是否已經為 ControlStyle 屬性建立。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
| CssClass |
取得或設定用戶端上 Web 伺服器控制項所呈現的階層式樣式表 (CSS)。 (繼承來源 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 |
取得控制項事件處理常式委派 (Delegate) 的清單。 這個屬性是唯讀的。 (繼承來源 Control) |
| ExtractTemplateRows | |
| 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 |
取得或設定指派給伺服器控制項的程式設計識別項。 (繼承來源 Control) |
| IdSeparator |
取得用來分隔控制項識別項的字元。 (繼承來源 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 |
取得伺服器控制項唯一的、符合階層架構的識別項。 (繼承來源 Control) |
| UseAccessibleHeader |
取得或設定值，指出資料清單控制項是否能夠以可存取格式呈現其標頭。 這個屬性可讓協助技術裝置的使用者更容易存取控制項。 (繼承來源 BaseDataList) |
| ValidateRequestMode |
取得或設定值，指出控制項是否對來自瀏覽器的用戶端輸入檢查潛在的危險值。 (繼承來源 Control) |
| ViewState |
取得狀態資訊的字典，允許您在相同網頁的多個要求之間，儲存和還原伺服器控制項的檢視狀態。 (繼承來源 Control) |
| ViewStateIgnoresCase |
取得值，指出 StateBag 物件是否不區分大小寫。 (繼承來源 Control) |
| ViewStateMode |
取得或設定這個控制項的檢視狀態模式。 (繼承來源 Control) |
| Visible |
取得或設定值，指出伺服器控制項是否會轉譯為頁面上的 UI。 (繼承來源 Control) |
| Width |
取得或設定 Web 伺服器控制項的寬度。 (繼承來源 WebControl) |
方法
事件
| 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) |
針對指定的資料控制項啟用動態資料行為。 |
