Fork me on GitHub

UrlPager 类

ASP.NET应用程序中支持使用路由来生成自定义分页url的分页控件。

C# 语法:

public class UrlPager:WebControl,INamingContainer

属性:

名称说明
AlwaysShowFirstLastPageNumber获取或设置一个值,该值指示是否总是显示第一页和最后一页数字页索引。
AutoHide获取或设置一个值,该值指示要分页的总记录数不只有一页时是否自动隐藏分页控件。
ContainerTag获取或设置容器标签的名称。
CurrentPageIndex获取或设置当前页索引。
CurrentPageNumberFormatString获取或设置当前页索引文本格式字符串。
CurrentPagerItemTemplate获取或设置当前页索引的html模板字符串。
DisabledPagerItemTemplate获取或设置不活动的分页元素的html模板字符串。
EndItemIndex获取当前页的结束数据项的索引。
FirstPageText获取或设置首页分页元素显示的文本。
InheritsRouteValues获取或设置一个值,该值指示是否继续当前页面中的路由值,如果该值为true,则当前页面的路由值也将被加入到RouteValues属性中。
LastPageText获取或设置尾页分页元素显示的文本。
MorePagerItemTemplate获取或设置更多页分页元素的html模板字符串。
MorePageText获取或设置更多页分页元素显示的文本。
NavigationPagerItemTemplate获取或设置上页、下页、首页和尾页四个分页元素的html模板字符串。
NextPageText获取或设置后一页分页元素显示的文本。
NumericPagerItemCount获取或设置分页控件显示的数字页索引的数目。
NumericPagerItemTemplate获取或设置数字页索引的html模板字符串。
PageIndexParameterName获取或设置url中当前页索引的参数名,如果该参数名在路由中不存在,则参数将被添被添加到url的QueryString参数中。
PageNumberFormatString获取或设置分页控件显示的数字页索引的格式字符串。
PagerItemTemplate获取或设置所有分页元素(数字页索引、更多页及上页、下页、首页和尾页等)的html模板字符串。
PageSize获取或设置每页显示的记录数。
PrevPageText获取或设置前一页分页元素显示的文本。
ReversePageIndex获取或设置一个值,该值指示是否以反方向显示分页页索引参数,以利于优化搜索引擎搜索结果。
RouteName获取或设置UrlPager分页控件要使用的路由表中的路由名称。
RouteValues获取或设置要应用到当前路由中的路由值(键/值对)。
ShowDisabledPagerItems获取或设置一个值,该值指示是否显示不活动的分页元素(当前页为第一页时为首页和前一页,当前页为最后一页时为尾页和后一页)。
ShowFirstLast获取或设置一个值,该值指示是否显示首页和尾页分页元素。
ShowMorePagerItems获取或设置一个值,该值指示是否显示更多页分页元素。
ShowNumericPagerItems获取或设置一个值,该值指示是否显示数字页索引分页元素。
ShowPrevNext获取或设置一个值,该值指示是否显示前一页和后一页分页元素。
StartItemIndex获取当前页的起始数据项的索引。
TotalItemCount获取或设置要分页的记录总数。
TotalPageCount获取要分页的数据的总页数。

方法:

名称说明
AddAttributesToRender重写System.Web.UI.WebControls.WebControl.AddAttributesToRender 方法,将需要呈现的 HTML 属性和样式添加到指定的 System.Web.UI.HtmlTextWriter 中。
OnInit重写 System.Web.UI.Control.OnInit 方法。
OnLoad重写 System.Web.UI.Control.OnLoad 方法。
OnPageChanged触发 PageChanged 事件。
OnPreRender重写System.Web.UI.Control.OnPreRender方法。
RenderBeginTag重写 System.Web.UI.WebControls.WebControl.RenderBeginTag 方法,将控件的 HTML 开始标记输出到指定的 System.Web.UI.HtmlTextWriter 编写器中。
RenderContents重写 System.Web.UI.WebControls.WebControl.RenderContents 方法,将控件的内容呈现到指定 System.Web.UI.HtmlTextWriter 的编写器中。
RenderEndTag重写 System.Web.UI.WebControls.WebControl.RenderEndTag 方法,将控件的 HTML 结束标记输出到指定的 System.Web.UI.HtmlTextWriter 编写器中。

事件:

名称说明
PageChanged分页控件所在的页面重新加载且没有回发时发生。