适用于：
Microsoft® ASP.NET

摘要：解决向任何 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 控件的编程接口

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