航模式,即下一页/上一页和数字页面。此外,其特殊属性 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 和 上一页 [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] ... 下一页 >> |