使用 asp+ 列表绑定控件
nikhil kothari
microsoft corporation
2000年7月
摘要： 说明 asp+ repeater、datalist 和 datagrid 服务器控件。这些控件能够实现一个根植于数据源的，基于 html 的应用程序用户界面。讨论与这些控件有关的概念并概要介绍使用这些控件的基本示例。
目录
简介
列表绑定控件是如何工作的？
repeater 控件
datalist 控件
datagrid 控件
repeater、datalist 或 datagrid？
相关资源
下载与本文相关的示例文件 (56 kb)。
简介
repeater、datalist 和 datagrid 控件构成 asp+ 页面框架中 system.web.ui.webcontrols 名称空间内的相关 web 控件集。这些控件使 html 显示所绑定列表或数据源的内容。因此，将它们统称为“列表绑定控件”。
与框架中的其它 web 控件类似，这些控件提供一致的编程模型并封装一个独立于浏览器的表示逻辑。这些特性使开发人员能够针对对象模型编程而不用必须掌握与 html 相关的那些不一致的和复杂的技术知识。
这三种控件可以按多种布局（包括列表、分栏/报纸栏目和流布局（html 流））来表示与其相关的数据源内容。此外，它们还允许您创建完全不同的或完全定制的布局。除了封装有表示逻辑外，还提供了用来处理已发送数据、执行状态管理和引发事件的功能。最后，它们还对诸如选择、编辑、分页和排序之类的标准操作提供不同级别的支持。这些控件可以简化几种常见的 web 应用程序方案，包括报表、购物车、产品列表、查询结果和导航菜单。
下面几节将进一步说明这些控件和如何在您的 web 应用程序中使用它们，以及如何选用控件。
列表绑定控件是如何工作的？
本节是本文其余部分的背景材料。概述了这些列表绑定控件的工作方式、它们的共同特性以及某些相关概念。
datasource 属性
每个控件都有一个 datasource 属性，其类型为 system.collections.icollection。用最简单的话来说，数据源是同类对象的一个列表或集合。
此框架中有几个对象提供了 icollection 的实现。这个集合包括 system.data.dataview （它通常用来访问关系数据库和 xml 数据）、一般 icollection 实现（如 arraylist 和 hashtable）以及数组。
与传统的数据绑定控件（它们通常需要 ado 记录集）不同，除了实现 icollection 接口之外，这些列表绑定控件未对其数据源强加任何其它要求。根据设计，通过大量增加可作为有效 datasource 属性值的类型和数据结构，它们能够为您的应用程序代码实现最大程度的简单和灵活性。
项目集合
每个列表绑定控件都包含一个项目集合。控件通过列举这些对象当前的数据源来置入其项目集合。在列举中为每个对象创建单个项目并用于表示该对象。这些项目同时成为列表绑定控件中包含的控件层次结构的一部分。
下表列出了与数据源的数据相关联的项目类型。
项目 创建的默认项目类型
alternatingitem 为项目集合中具有奇数下标的项目创建
selecteditem 为选定的项目创建（不论该项目是否为备选项目）
edititem 为处于编辑模式下的项目创建（不管它是否被选中或是否为备选项目）
控件同时创建将在表示中用到的下列项目。但是，它们并不与数据源的数据相关联。
标头 用来表示标头信息
注脚 用来表示注脚信息
分隔符 用来表示图 1 中所示的每个项目之间的内容，并且仅适用于 repeater 和 datalist
分页符 用来表示与 datagrid 控件相关联的分页 ui
图 1. 相对于“控件”集合的“项目”集合
项目的数据绑定和创建
列表绑定控件遵循在整个 asp+ 框架中实现的显式数据绑定模型。这意味着控件仅当其 databind 方法被调用时才需要并列举其数据源。
当调用 databind 方法时，列表控件将列举其数据源、创建项目并通过从其数据源中提取值来对其进行初始化。如果启用了状态管理，则控件还将保存所需的全部信息，以便在页面的回传处理期间重新创建其项目而无须重新设置数据源。
显式数据绑定模型使您的应用程序代码可以精确地确定在处理序列中何时及何处需要数据源。这种功能使对数据库服务器的访问更少且更高效，而这些访问通常是 web 应用程序最耗费资源的操作。
一般规则是每当您需要重新创建项目时都必须调用 databind。在大多数情况下，您将在您的页面首次被请求创建初始项目集合时调用 databind。在该页面的后续执行过程中，您将需要在引起项目集合被更改的各种事件处理程序中调用此方法。当用于创建初始数据源的查询被修改时，就可能发生这种情况。当项目的状态改变（如从只读模式变为编辑模式）时也可能发生这种情况。
样式
通过在对象模型上使用样式属性，您可以定义全部 datalist 和 datagrid 控件及其所包含项目的格式和外观。这些属性允许定制字体、颜色、边框和其它外观因素。控件本身的样式属性（如前景色、背景色、字体和边框样式）将影响整个控件的表示。
此外，每个控件都包含与其所创建的项目类型相匹配的大量样式属性，如 as itemstyle、alternatingitemstyle 和 headerstyle。datagrid 提供第三级的样式属性，这些属性将影响特定列的所有单元格。控件中包含的每一列都可以拥有其自己的 headerstyle、footerstyle 和 itemstyle。
模板
样式控制格式显示，而模板则定义每个项目的内容和表示。您可以将模板看作 html 代码片断，它定义了用来表示项目的控件层次结构。
repeater 和 datalist 控件由您指定的模板来驱动，提供各种可设置的模板属性，如 itemtemplate、alternatingitemtemplate 和 headertemplate。与样式类似，每个模板都对应于一个特定类型的项目。
datagrid 控件未模板化。但是，控件的 column 集合中的 templatecolumns 使 datagrid 中模板的使用成为可能。templatecolumn 中的每个单元格都可以包含一个模板，这与 repeater 或 datalist 控件中的项目极为类似。这也使 datagrid 中的定制表示成为可能。
模板中的数据绑定
模板定义项目中包含的控件层次结构。通过使用数据绑定表达式，此层次结构中的控件属性可绑定到与此项目相关联的数据属性上。
作为模板的逻辑父级的项目在数据绑定表达式中被称为“容器”。每个容器都有一个称为 dataitem 的属性，该属性引用其相关联的数据。结果是，模板中的大多数典型数据绑定表达式都将控件属性绑定到 container.dataitem 的某个属性上。将在以下几节介绍的示例中进一步说明这种绑定。
repeater 控件
如前面所述，repeater 控件是完全由模板驱动的，允许创建完全可定制的表示和布局。下图说明了这一功能。
图 2. 使用 repeater 控件生成的带项目符号的链接列表
摘自 repeater1.aspx：
<%@ page language=c# src=repeater1.cs inherits=samples.repeater1page%>
...
<asp:repeater runat=server id=linkslistrepeater
datasource='<%# sitelinks %>'>
<template name=headertemplate>
<ul type=1>
</template>
<template name=itemtemplate>
<li>
<asp:hyperlink runat=server
text='<%# databinder.eval(container.dataitem, sitename) %>'
navigateurl='<%# databinder.eval(container.dataitem, siteurl) %>'>
</asp:hyperlink>
</li>
</template>
<template name=footertemplate>
</ul>
</template>
</asp:repeater>
此 .aspx 文件显示了一个用于生成带项目符号列表的 repeater 控件的声明。
此示例说明了用数据绑定语法 (<%#...%>) 设置数据源的声明方法。当您调用 databind 方法时，数据绑定中的表达式就会被执行。在这种情况下，repeater 的 datasource 属性被绑定到页面的 sitelinks 属性上，后者包含要显示的 url 引用。
repeater 是唯一允许在其模板中存在 html 片段的控件，将 repeater 控件和 html 片段合在一起会产生良好形式的 html。在本示例中，带项目符号的列表分为三个部分：
由 headertemplate 表示的列表开始标记 (<ul type=1>)。
由 footertemplate 表示的列表结束标记 (</ul>)。
列表的主体由通过为 sitelinks 集合中出现的每个对象重复 itemtemplate 而生成的列表项 (<li>) 置入。
您也可以使用这些模板在标头中指定表的开始标记 (<table>)，在注脚中指定表的结束标记(</table>)，在每个项目中指定单个表行 (<tr>)。此替换选项将导致列表表示。
您必须指定 itemtemplate。它是唯一必需的模板。当未指定其它模板时，控件会自动将此 itemtemplate 用于其它模板。
在以下示例中，itemtemplate 包含一个 hyperlink web 控件。此控件的 text 和 navigateurl 属性被绑定到与每个重复项目相关联的数据属性上。这又是使用数据绑定表达式（在创建项目后立即对该表达式求值）完成的。
repeater1.cs:
namespace samples {
...
public class repeater1page : page {
protected repeater linkslistrepeater;
public icollection sitelinks {
get {
arraylist sites = new arraylist();
sites.add(new siteinfo(microsoft home,
http://www.microsoft.com));
sites.add(new siteinfo(msdn home,
http://msdn.microsoft.com));
sites.add(new siteinfo(msn homepage,
http://www.msn.com));
sites.add(new siteinfo(hotmail,
http://www.hotmail.com));
return sites;
}
}
protected override void onload(eventargs e) {
base.onload(e);
if (!ispostback) {
// 首次请求该页时即对其进行数据绑定 (databind)。
// 这将在此页的控件层次结构中递归调用每个控件。
databind();
}
}
}
public sealed class siteinfo {
private string sitename;
private string siteurl;
public siteinfo(string sitename, string siteurl) {
this.sitename = sitename;
this.siteurl = siteurl;
}
public string sitename {
get { return sitename; }
}
public string siteurl {
get { return siteurl; }
}
}
}
此 .cs 文件包含随前一个列表中的 aspx 页一起出现的代码。
repeater1page 类覆盖了 page 类的 onload 方法。此表示在对该页的首次请求中调用 databind。这将导致对这些页上的数据绑定表达式求值并使 repeater 控件列举数据源以及创建其项目。仅在首次请求时调用 databind 方法。这之所以能正常工作是因为 repeater 能够在从前一次保存状态的回传过程中重新创建其项目，而无需数据源实例。
此页将类型 icollection 的公用属性显露出来。这将在设置 repeater 的 datasource 属性值的数据绑定表达式中使用。属性的获取实现使用包含一组 siteinfo 对象序列的 arraylist。此属性是公用的，因为只有页类的公用和保护成员可在数据绑定表达式中使用。
每个 siteinfo 对象有两个属性：sitename 和 siteurl。当对模板中的 hyperlink 控件进行数据绑定时将访问这些属性。在此控件的绑定表达式中，container.dataitem 表示要将特定项绑定到其上的单个 siteinfo 对象。databinder.eval(container.dataitem, sitename) 访问当前 siteinfo 对象的 sitename 属性。
repeater1 示例向您介绍了几个基本概念：
定义模板
模板中的数据绑定语法和数据绑定表达式
将 arraylist 的 icollection 表示用作数据源
在最初处理页的过程中调用 databind 方法
datalist 控件
datalist 控件是一个模板化控件，它提供使用样式属性可视化地格式化其表示的能力。它也可以产生多列布局。图 3 说明了这两种特性。
图 3. 从 datalist 的双列表示生成的示例
摘自 datalist1.aspx：
<%@ page language=c# src=datalist1.cs inherits=samples.datalist1page%>
...
<asp:datalist runat=server id=peopledatalist
repeatcolumns=2 repeatdirection=vertical repeatmode=table
width=100%>
<property name=alternatingitemstyle>
<asp:tableitemstyle backcolor=#eeeeee/>
</property>
<template name=itemtemplate>
<asp:panel runat=server font-size=12pt font-bold=true>
<%# ((person)container.dataitem).name %>
</asp:panel>
<asp:label runat=server width=20px
borderstyle=solid borderwidth=1px bordercolor=black
backcolor='<%# ((person)container.dataitem).favoritecolor %>'>
</asp:label>
<asp:label runat=server font-size=10pt
text='<%# getcolorname(((person)container.dataitem).favoritecolor) %>'>
</asp:label>
</template>
</asp:datalist>
此 .aspx 文件显示了用来生成此示例的 datalist 的声明。
在此示例中，datalist 的多列布局是通过将 repeatcolumns 属性设置为“2”来实现的。将 repeatdirection 设置为“vertical”会使项目从上到下、然后从左到右排列。相反，值设置为“horizontal”会导致项目从左到右、然后从上到下排列。
aspx 语法包含对少数几种 datalist 的样式属性的设置。在此示例中，datalist 的 width 被设置为其父级的 100%。设置具有灰色背景的 alternatingitemstyle 是为了获得带有条纹的外观。此示例还说明模板可以包含任意复杂的控件定义，以满足在每个项目内获得理想布局的需要。
最后，此模板中的数据绑定表达式通过将 container.dataitem 转换为其类型来使用前期绑定。这不会招致与使用 databinder.eval （如 repeater1 中所示) 相关联的后期绑定的代价。但是，这种方法可能会产生可读性较差的表达式。以下示例还给出了一个调用 getcolorname 方法（该方法是在本页有代码支持的文件中实现的）的表达式示例。
datalist1.cs:
namespace samples {
...
public class datalist1page : page {
protected datalist peopledatalist;
protected string getcolorname(color c) {
return
typedescriptor.getconverter(typeof(color)).converttostring(c);
}
private void loadpeoplelist() {
// 创建数据源
person[] people = new person[] {
new person(nikhil kothari, color.green),
new person(steve millet, color.purple),
new person(chris anderson, color.blue),
new person(mike pope, color.orange),
new person(anthony moore, color.yellow),
new person(jon jung, color.mediumaquamarine),
new person(susan warren, color.slateblue),
new person(izzy gryko, color.red)
};
// 设置控件的数据源
peopledatalist.datasource = people;
// 并使该控件用此数据源构建其项目
peopledatalist.databind();
}
protected override void onload(eventargs e) {
base.onload(e);
if (!ispostback) {
// 首次请求此页
loadpeoplelist();
}
}
}
public sealed class person {
private string name;
private color favoritecolor;
public person(string name, color favoritecolor) {
this.name = name;
this.favoritecolor = favoritecolor;
}
public color favoritecolor {
get { return favoritecolor; }
}
public string name {
get { return name; }
}
}
}
在此页中，控件的 datasource 属性是通过程序设置的，与在 aspx 文件中声明性地设置相对。两种方法的结果相同。无法选择哪种方法，都必须调用 databind 方法，以便控件可以列举其数据源并创建它要表示的项目。
此示例中所用的数据源是 person 对象的一个简单数组。由于每个数组都实现 icollection 方法，所以数组适合用作数据源。这显示了将数据结构和类型用作数据源时可获得的灵活程度。
datalist1 示例介绍了下列概念：
在模板中定义丰富的 html ui
使用简单数组作为数据源
通过程序设置数据源
数据绑定语法中所允许的各种表达式