BaseDataList 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
public ref class BaseDataList abstract : System::Web::UI::WebControls::WebControl
public abstract class BaseDataList : System.Web.UI.WebControls.WebControl
type BaseDataList = class
inherit WebControl
Public MustInherit Class BaseDataList
Inherits WebControl
- 继承
- 派生
注解
类 BaseDataList 为所有数据列表控件(如 DataList 和 DataGrid)提供通用功能。 数据列表控件用于显示数据源(如控件)中的 System.Data.DataView 记录。 每个数据列表控件都可以具有独特的显示样式和功能。 BaseDataList由于 类是抽象的,因此不会直接创建此类的实例。 相反,数据列表控件继承此类中所有数据列表控件通用的方法和属性。
可以通过设置此类的某些属性来控制数据列表控件的外观。 若要确定数据列表控件的单元格之间的间距,请设置 CellSpacing 属性。 若要确定单元格内容与单元格边框之间的间距量,请设置 CellPadding 属性。 可以通过设置 GridLines 属性来显示数据列表控件的各个单元格之间的边框。 数据列表控件单元格中内容的水平对齐方式由 HorizontalAlign 属性控制。
类 BaseDataList 提供两个属性来支持数据绑定。 若要将数据绑定到实现 System.Collections.IEnumerable 接口 ((如 System.Data.DataView 或 System.Collections.ArrayList) 或 IListSource 接口)的任何集合,请使用 DataSource 属性指定数据源。 设置 DataSource 属性时,必须手动编写代码以执行数据绑定。 若要将数据列表控件自动绑定到由数据源控件表示的数据源,请使用 DataSourceID 属性并将其值 ID 设置为要使用的数据源控件的 属性。 设置 DataSourceID 属性时,数据列表控件会自动绑定到指定的数据源控件。 因此,无需显式调用 DataBind 方法。
如果 属性指定的 DataSource 数据源包含多个数据源,请使用 DataMember 属性指定要绑定到控件的特定源。 例如,如果对象 System.Data.DataSet 具有多个表,则必须指定要绑定到控件的表。 指定数据源后,使用 DataBind 方法将数据源绑定到 控件。
类 BaseDataList 包含一个 DataKeys 集合,该集合存储 (在数据列表控件中显示为行) 的每条记录的键字段。 这使你可以使用数据列表控件存储键字段,而无需在控件中显示它。 键字段通常用作更新查询字符串的一部分,用于修改数据源中的特定记录。 集合由 属性指定的 DataKeyField 字段中的值填充。
类 BaseDataList 提供控件 SelectedIndexChanged 中所选项发生更改时引发的事件。 这样,就可以创建一个自定义事件处理程序,该处理程序在引发事件时执行一组特定的指令。
实施者说明
当从 BaseDataList 继承时,必须重写下面的成员:CreateControlHierarchy(Boolean) 和 PrepareControlHierarchy()。
构造函数
BaseDataList() |
初始化 BaseDataList 类的新实例。 |
属性
AccessKey |
获取或设置使您得以快速导航到 Web 服务器控件的访问键。 (继承自 WebControl) |
Adapter |
获取控件的浏览器特定适配器。 (继承自 Control) |
AppRelativeTemplateSourceDirectory |
获取或设置包含该控件的 Page 或 UserControl 对象的应用程序相对虚拟目录。 (继承自 Control) |
Attributes |
获取与控件的特性不对应的任意特性(只用于呈现)的集合。 (继承自 WebControl) |
BackColor |
获取或设置 Web 服务器控件的背景色。 (继承自 WebControl) |
BindingContainer |
获取包含该控件的数据绑定的控件。 (继承自 Control) |
BorderColor |
获取或设置 Web 控件的边框颜色。 (继承自 WebControl) |
BorderStyle |
获取或设置 Web 服务器控件的边框样式。 (继承自 WebControl) |
BorderWidth |
获取或设置 Web 服务器控件的边框宽度。 (继承自 WebControl) |
Caption |
获取或设置要在控件中的 HTML 标题元素中呈现的文本。 提供此属性的目的是使辅助技术设备的用户更易于访问控件。 |
CaptionAlign |
获取或设置控件中的 HTML 标题元素的水平或垂直位置。 提供此属性的目的是使辅助技术设备的用户更易于访问控件。 |
CellPadding |
获取或设置单元格的内容和单元格的边框之间的空间量。 |
CellSpacing |
获取或设置单元格间的空间量。 |
ChildControlsCreated |
获取一个值,该值指示是否已创建服务器控件的子控件。 (继承自 Control) |
ClientID |
获取由 ASP.NET 生成的 HTML 标记的控件 ID。 (继承自 Control) |
ClientIDMode |
获取或设置用于生成 ClientID 属性值的算法。 (继承自 Control) |
ClientIDSeparator |
获取一个字符值,该值表示 ClientID 属性中使用的分隔符字符。 (继承自 Control) |
Context |
为当前 Web 请求获取与服务器控件关联的 HttpContext 对象。 (继承自 Control) |
Controls |
获取 ControlCollection 对象,它包含数据列表控件中的子控件的集合。 |
ControlStyle |
获取 Web 服务器控件的样式。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
ControlStyleCreated |
获取一个值,该值指示是否已为 Style 属性创建了 ControlStyle 对象。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
CssClass |
获取或设置由 Web 服务器控件在客户端呈现的级联样式表 (CSS) 类。 (继承自 WebControl) |
DataItemContainer |
如果命名容器实现 IDataItemContainer,则获取对命名容器的引用。 (继承自 Control) |
DataKeyField |
获取或设置由 DataSource 属性指定的数据源中的键字段。 |
DataKeys |
获取 DataKeyCollection 对象,它存储数据列表控件中每个记录的键值。 |
DataKeysArray |
获取 ArrayList 对象,它包含数据列表控件中每个记录的键值。 |
DataKeysContainer |
如果命名容器实现 IDataKeysControl,则获取对命名容器的引用。 (继承自 Control) |
DataMember |
获取或设置多成员数据源中要绑定到数据列表控件的特定数据成员。 |
DataSource |
获取或设置源,该源包含用于填充控件中的项的值列表。 |
DataSourceID |
获取或设置数据源控件的 ID 属性,数据列表控件应使用它来检索其数据源。 |
DesignMode |
获取一个值,该值指示是否正在使用设计图面上的一个控件。 (继承自 Control) |
Enabled |
获取或设置一个值,该值指示是否启用 Web 服务器控件。 (继承自 WebControl) |
EnableTheming |
获取或设置一个值,该值指示主题是否应用于该控件。 (继承自 WebControl) |
EnableViewState |
获取或设置一个值,该值指示服务器控件是否向发出请求的客户端保持自己的视图状态以及它所包含的任何子控件的视图状态。 (继承自 Control) |
Events |
获取控件的事件处理程序委托列表。 此属性为只读。 (继承自 Control) |
Font |
获取与 Web 服务器控件关联的字体属性。 (继承自 WebControl) |
ForeColor |
获取或设置 Web 服务器控件的前景色(通常是文本颜色)。 (继承自 WebControl) |
GridLines |
获取或设置一个值,该值指定是否显示数据列表控件的单元格之间的边框。 |
HasAttributes |
获取一个值,该值指示控件是否具有特性集。 (继承自 WebControl) |
HasChildViewState |
获取一个值,该值指示当前服务器控件的子控件是否具有任何已保存的视图状态设置。 (继承自 Control) |
Height |
获取或设置 Web 服务器控件的高度。 (继承自 WebControl) |
HorizontalAlign |
获取或设置数据列表控件在其容器内的水平对齐方式。 |
ID |
获取或设置分配给服务器控件的编程标识符。 (继承自 Control) |
IdSeparator |
获取用于分隔控件标识符的字符。 (继承自 Control) |
Initialized |
获取一个值,该值指示控件是否已经初始化。 |
IsBoundUsingDataSourceID |
获取指示是否设置 DataSourceID 属性的值。 |
IsChildControlStateCleared |
获取一个值,该值指示该控件中包含的控件是否具有控件状态。 (继承自 Control) |
IsEnabled |
获取一个值,该值指示是否启用控件。 (继承自 WebControl) |
IsTrackingViewState |
获取一个值,用于指示服务器控件是否会将更改保存到其视图状态中。 (继承自 Control) |
IsViewStateEnabled |
获取一个值,该值指示是否为该控件启用了视图状态。 (继承自 Control) |
LoadViewStateByID |
获取一个值,该值指示控件是否通过 ID 而不是索引参与加载其视图状态。 (继承自 Control) |
NamingContainer |
获取对服务器控件的命名容器的引用,此引用创建唯一的命名空间,以区分具有相同 ID 属性值的服务器控件。 (继承自 Control) |
Page |
获取对包含服务器控件的 Page 实例的引用。 (继承自 Control) |
Parent |
获取对页 UI 层次结构中服务器控件的父控件的引用。 (继承自 Control) |
RenderingCompatibility |
获取一个值,该值指定呈现的 HTML 将与之兼容的 ASP.NET 版本。 (继承自 Control) |
RequiresDataBinding |
获取或设置一个值,该值指示数据列表控件是否需要绑定到其指定的数据源。 |
SelectArguments |
获取数据绑定控件从数据源控件检索数据时使用的 DataSourceSelectArguments 对象。 |
Site |
获取容器信息,该容器在呈现于设计图面上时承载当前控件。 (继承自 Control) |
SkinID |
获取或设置要应用于控件的外观。 (继承自 WebControl) |
Style |
获取将在 Web 服务器控件的外部标记上呈现为样式特性的文本特性的集合。 (继承自 WebControl) |
SupportsDisabledAttribute |
获取一个值,该值指示在控件的 |
SupportsDisabledAttribute |
获取一个值,该值指示在控件的 |
TabIndex |
获取或设置 Web 服务器控件的选项卡索引。 (继承自 WebControl) |
TagKey |
获取对应于此 Web 服务器控件的 HtmlTextWriterTag 值。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
TagName |
获取控件标记的名称。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
TemplateControl |
获取或设置对包含该控件的模板的引用。 (继承自 Control) |
TemplateSourceDirectory |
获取包含当前服务器控件的 Page 或 UserControl 的虚拟目录。 (继承自 Control) |
ToolTip |
获取或设置当鼠标指针悬停在 Web 服务器控件上时显示的文本。 (继承自 WebControl) |
UniqueID |
获取服务器控件的唯一的、以分层形式限定的标识符。 (继承自 Control) |
UseAccessibleHeader |
获取或设置一个值,该值指示数据列表控件是否以可访问的格式呈现其标头。 提供此属性的目的是使辅助技术设备的用户更易于访问控件。 |
ValidateRequestMode |
获取或设置指示控件是否检查来自浏览器的客户端输入是否具有潜在危险值的值。 (继承自 Control) |
ViewState |
获取状态信息的字典,这些信息使您可以在同一页的多个请求间保存和还原服务器控件的视图状态。 (继承自 Control) |
ViewStateIgnoresCase |
获取一个值,该值指示 StateBag 对象是否不区分大小写。 (继承自 Control) |
ViewStateMode |
获取或设置此控件的视图状态模式。 (继承自 Control) |
Visible |
获取或设置一个值,该值指示服务器控件是否作为 UI 呈现在页上。 (继承自 Control) |
Width |
获取或设置 Web 服务器控件的宽度。 (继承自 WebControl) |
方法
事件
DataBinding |
当服务器控件绑定到数据源时发生。 (继承自 Control) |
Disposed |
当从内存释放服务器控件时发生,这是请求 ASP.NET 页时服务器控件生存期的最后阶段。 (继承自 Control) |
Init |
当服务器控件初始化时发生;初始化是控件生存期的第一步。 (继承自 Control) |
Load |
当服务器控件加载到 Page 对象中时发生。 (继承自 Control) |
PreRender |
在加载 Control 对象之后、呈现之前发生。 (继承自 Control) |
SelectedIndexChanged |
在两次服务器发送之间,在数据列表控件中选择了不同的项时发生。 |
Unload |
当服务器控件从内存中卸载时发生。 (继承自 Control) |
显式接口实现
扩展方法
FindDataSourceControl(Control) |
返回与指定控件的数据控件关联的数据源。 |
FindFieldTemplate(Control, String) |
返回指定控件的命名容器中指定列的字段模板。 |
FindMetaTable(Control) |
返回包含数据控件的元表对象。 |