摘要：解决向任何 ASP.NET 控件添加分页功能的问题。还为开发复合 ASP.NET 控件提供了很多有用的提示和技巧。

下载本文的源代码（英文）。（请注意，在示例文件中，程序员的注释使用的是英文，本文中将其译为中文是为了便于读者理解。）

从程序员的角度来看，Microsoft® SQL Server™ 查询的最大缺陷之一就是返回的行数通常比应用程序的用户界面实际可以容纳的行数要多得多。这种尴尬情形经常将开发人员陷于困境。开发人员是应该创建一个非常长的页面，让用户花时间去滚动浏览，还是应该通过设置一个手动分页机制来更好地解决这个问题？

哪种解决方案更好，在很大程度上取决于要检索的数据的特性。由多个项目（如搜索结果）组成的较长列表，最好通过各页大小相等、每页相对较短的多个页面显示。由单个项目（如文章的文本）组成的较长列表，如果整个插入在一个页面中，使用起来会更方便。最后得出的分析结果是，应该根据应用程序的总体用途来做决定。那么，Microsoft® ASP.NET 是如何解决数据分页问题的呢？

ASP.NET 提供了功能强大的数据绑定控件，以便将查询结果格式化为 HTML 标记。但是，这些数据绑定控件中只有一种控件（即 DataGrid 控件）本来就支持分页。其他控件（如 DataList、Repeater 或 CheckBoxList）则不支持分页。这些控件及其他列表控件不支持分页，不是因为它们在结构上不支持分页，而是因为它们与 DataGrid 不同，不包含任何处理分页的特定代码。但是，处理分页的代码是相当样板化的，可以添加到所有这些控件中。

Scott Mitchell 在最近的一篇题目为“Creating a Pageable, Sortable DataGrid”（英文）的文章中，介绍了 DataGrid 分页。该文还引用了 Web 上的其他有用信息，为您提供了有关网格分页基础知识和其他信息。如果想查看如何使 DataList 控件可以进行分页的示例，可以查看此文章（英文）。该文演示了如何创建一个自定义的 DataList 控件，该控件具有当前索引和页面大小属性，并可以启动页面更改事件。

同样的代码也可以用于满足其他列表控件（如 ListBox 和 CheckBoxList）的分页需要。不过，向各个控件添加分页功能实际上并不是一种非常好的做法，因为，如上所述，分页代码是相当样板化的。因此，对于聪明的程序员来说，有什么方法比使用一种新的通用分页程序控件来实现所有这些控件的分页功能更好的呢？

本文中将建立一个分页程序控件，它将使合作者列表控件能够对 SQL Server 的查询结果进行分页。该控件名为 SqlPager，它支持两种类型的合作者控件 - 列表控件和基础数据列表控件。

SqlPager 控件的显著特点

SqlPager 控件是一个 ASP.NET 复合控件，包含一个单行表格。该行又包含两个单元格 - 导航条和页面描述符。该控件的用户界面呈条形，理想情况下，其宽度与合作者控件的宽度相同。导航条部分提供了可单击的元素，以便在页面之间移动；页面描述符部分为用户提供了有关当前显示的页面的一些反馈信息。



图 1：Visual Studio .NET 网页设计器中显示的 SqlPager 控件

与 DataGrid 控件的嵌入式分页程序一样，SqlPager 控件具有两种导航模式，即下一页/上一页和数字页面。此外，其特殊属性 PagerStyle 使您能够选择更方便的样式。该控件与列表控件协同工作。您可以通过 ControlToPaginate 字符串属性为分页程序指定一个这样的合作者控件。

SqlPager1.ControlToPaginate = "ListBox1";

一般情况下，分页程序首先获取 SQL Server 的查询结果，准备一个适当的记录页面，然后通过合作者控件的 DataSource 属性显示该页面。当用户单击以查看新页面时，分页程序将检索请求的数据并再次通过合作者控件来显示数据。分页机制对于列表控件是完全透明的。列表控件的数据源是通过编程方式进行更新的，任何时候都只包含适合当前页面的记录。

控件的分页引擎具有多个 public 属性，如 CurrentPageIndex、ItemsPerPage 和 PageCount，通过这些属性来获取并设置当前页面的索引、每个页面的大小以及要显示的页面的总数。分页程序管理数据检索和分页所需的任何逻辑。

SelectCommand 属性设置获取数据所用的命令文本。ConnectionString 属性定义数据库的名称和位置以及连接凭据。执行查询时采用的方式取决于 PagingMode 属性的值。该属性的可能值为与其同名的 PagingMode 枚举的值 - Cached 和 NonCached。如果选择 Cached 选项，则将使用数据适配器和 DataTable 对象检索整个结果集。可以选择将结果集放置在 ASP.NET 的 Cache 对象中，该结果集可以重复使用直到过期。如果选择 NonCached 选项，则查询只检索适合当前页面的记录。这时，ASP.NET 的 Cache 中不放置任何数据。NonCached 模式与 DataGrid 控件的自定义分页模式几乎相同。

下表列出 SqlPager 控件的全部编程接口。

表 1：SqlPager 控件的编程接口

名称 类型 说明
CacheDuration 属性 指示数据在 ASP.NET 的缓存中保留的秒数。只用于 Cached 模式。默认值为 60 秒。
ConnectionString 属性 用来访问所选择的 SQL Server 数据库的连接字符串。
ControlToPaginate 属性 同一个 .aspx 页面中的控件 ID，它将显示分页程序检索的记录页面。这是合作者控件。
CurrentPageIndex 属性 获取并设置基于 0 的页面索引。
ItemsPerPage 属性 获取并设置每页要显示的记录数量。默认值为每页显示 10 个项目。
PagerStyle 属性 该值指示分页程序用户界面的样式。它可以为 PagerStyle 枚举值：NextPrev 和 NumericPages 之一。在 NextPrev 模式中，将显示 VCR 式的按钮，来转到第一页、上一页、下一页和最后一页。而在 NumericPages 模式中，将显示一个下拉列表，列出所有可用页面的索引。
PagingMode 属性 该值指示检索数据的方式。它可以为 PagingMode 枚举值：Cached 和 NonCached 之一。如果为 Cached，则将使用数据适配器，且整个结果集将临时放置在 ASP.NET 缓存中。如果为 NonCached，则只检索当前页面中的记录。在这种情况下，不进行缓存。
SelectCommand 属性 用来进行查询的命令文本。最好为 SELECT-FROM-WHERE 形式。不支持 ORDER BY 子句。排序是通过 SortField 属性另外指定的。
SortField 属性 用来排序的字段的名称。此字段用于为查询提供动态的 ORDER BY 子句。排序是由 SQL Server 执行的。
ClearCache 方法 删除存储在 ASP.NET 缓存中的任何数据。
PageIndexChanged 事件 默认事件，当分页程序移动到另一个页面时发生。事件的数据结构为 PageChangedEventArgs 类，包含旧页面和新页面的索引。

由于 SqlPager 控件继承了 WebControl，因此它也具有很多与 UI 相关的属性来管理字体、边框和颜色。

生成 SqlPager 控件

将作为复合控件来生成 SqlPager 控件并让其继承 WebControl 类。复合控件是 ASP.NET 服务器控件所特有的，它是由一个或多个服务器控件组成。

public class SqlPager : WebControl, INamingContainer
{ ... }

除非生成完全自定义的控件或扩展现有的控件，否则，创建新控件时，大多数时间实际上是在生成复合控件。要创建 SqlPager，组合一个 Table 控件，并根据分页程序的样式，组合几个 LinkButton 控件或者一个 DropDownList 控件。

生成复合控件时，需要注意几条原则。首先，需要覆盖 CreateChildControls protected 方法。CreateChildControls 方法是从 Control 继承来的，当服务器控件为了显示而要创建子控件时或在返回后，将调用此方法。

protected ove