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 窗体代码模型的详细信息，请参阅 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 网页中的用户输入。
声明性语法
<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) 类。 (继承自 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 | |
| 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 |
获取对页 UI 层次结构中服务器控件的父控件的引用。 (继承自 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) |
为指定数据控件启用动态数据行为。 |
