BaseDataList 类

项目
08/17/2007

用作数据列表控件的抽象基类，如 DataList 和 DataGrid。此类提供所有数据列表控件的公共方法和属性。

**命名空间:**System.Web.UI.WebControls
**程序集:**System.Web（在 system.web.dll 中）

语法

声明
Public MustInherit Class BaseDataList
    Inherits WebControl
用法
Dim instance As BaseDataList

public abstract class BaseDataList : WebControl

public ref class BaseDataList abstract : public WebControl

public abstract class BaseDataList extends WebControl

public abstract class BaseDataList extends WebControl

备注

BaseDataList 类提供所有数据列表控件的公共功能，如 DataList 和 DataGrid。数据列表控件用于显示数据源的记录，如 System.Data.DataView 控件。每个数据列表控件都可以有唯一的显示样式和功能。因为 BaseDataList 类是抽象的，所以不直接创建此类的实例。相反，数据列表控件从此类继承所有数据列表控件的公共方法和属性。

可以通过设置此类的某些属性来控制数据列表控件的外观。若要确定数据列表控件单元格之间的间距量，请设置 CellSpacing 属性。若要确定单元格的内容和单元格的边框之间的间距量，请设置 CellPadding 属性。通过设置 GridLines 属性，可以显示数据列表控件各个单元格之间的边框。数据列表控件单元格中的内容的水平对齐方式由 HorizontalAlign 属性控制。

BaseDataList 类提供了两个属性以支持数据绑定。若要将数据绑定到实现 System.Collections.IEnumerable 接口（例如 System.Data.DataView、System.Collections.ArrayList 和 System.Collections.Hashtable）或 IListSource 接口的任何对象，请使用 DataSource 属性来指定数据源。在设置 DataSource 属性时，必须手动编写代码才能执行数据绑定。若要将数据列表控件自动绑定到数据源控件所表示的数据源，请使用 DataSourceID 属性并将其值设置为要使用的数据源控件的 ID 属性。在设置 DataSourceID 属性时，数据列表控件自动绑定到指定的数据源控件。因此，不需要显式调用 DataBind 方法。

如果由 DataSource 属性指定的数据源包含多个数据的源，请使用 DataMember 属性指定要绑定到该控件的特定的源。例如，如果有包含多个表的 System.Data.DataSet 对象，必须指定要绑定到控件的表。指定了数据源后，使用 DataBind 方法将数据源绑定到控件。

BaseDataList 类包含一个 DataKeys 集合，它存储数据列表控件中的每个记录的键字段（显示为一行）。这使您可以用数据列表控件存储键字段而无需在控件中显示它。键字段通常用作更新查询字符串的一部分，以修改数据源中的特定记录。此集合用 DataKeyField 属性指定的字段中的值填充。

BaseDataList 类提供一个 SelectedIndexChanged 事件，当控件中的选定项更改时会引发该事件。这使您得以创建一个自定义事件处理程序，以便在该事件引发时执行一组特定的指令。

给继承者的说明 当从 BaseDataList 继承时，必须重写下列成员：CreateControlHierarchy 和 PrepareControlHierarchy。

.NET Framework 安全性

AspNetHostingPermission 用于在宿主环境中进行操作。要求值：LinkDemand；权限值：Minimal。
AspNetHostingPermission 用于在宿主环境中进行操作。要求值：InheritanceDemand；权限值：Minimal。

继承层次结构

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.BaseDataList
         System.Web.UI.WebControls.DataGrid
         System.Web.UI.WebControls.DataList

线程安全

此类型的任何公共静态（Visual Basic 中的 Shared）成员都是线程安全的，但不保证所有实例成员都是线程安全的。

平台

Windows 98、Windows 2000 SP4、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

请参见

参考

BaseDataList 成员
 System.Web.UI.WebControls 命名空间
 DataGrid
DataList
CellSpacing
CellPadding
GridLines
HorizontalAlign
DataSource
DataMember
DataBind
DataKeys
DataKeyField
SelectedIndexChanged
System.Collections.IEnumerable
System.Data.DataView
System.Collections.ArrayList
System.Collections.Hashtable
System.Data.DataSet

通过