AspNetPager分页控件的使用以及常见错误

原文发布时间为：2009-05-25 —— 来源于本人的百度文章 [由搬家工具导入]

【Repeater采用AspNetPager分页成功↓】

using System;
using System.Configuration;
using System.Data;
using System.Data.SqlClient;
/* 工具箱中添加AspNetPager控件（Bin文件夹中添加AspNetPager.dll的先） */
using Wuqi.Webdiyer;

public partial class _Default : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        SqlConnection conn = new SqlConnection(ConfigurationManager.ConnectionStrings["HouseConnectionString"].ConnectionString);
        SqlCommand cmd = new SqlCommand("select count(guid) from hire",conn);
        conn.Open();

        ///获取总记录数
        int num = Convert.ToInt32(cmd.ExecuteScalar());

         ///将总记录数赋值给AspNetPager1对象
         AspNetPager1.RecordCount = num;

        message.Text = "总记录条数：" + num.ToString();
        DepeaterDataBind();
        conn.Close();
    }

    private void DepeaterDataBind()

    {

        SqlConnection conn = new SqlConnection(ConfigurationManager.ConnectionStrings["HouseConnectionString"].ConnectionString);

        String sqlStr ="SELECT [guid], [name], [date] FROM [hire] ORDER BY [date] DESC";

        SqlDataAdapter da = new SqlDataAdapter(sqlStr, conn);

        DataSet ds = new DataSet();

        try

        {
            da.Fill(ds, AspNetPager1.PageSize * (AspNetPager1.CurrentPageIndex - 1), AspNetPager1.PageSize, "curTable");

            Repeater1.DataSource = ds.Tables["curTable"];

            Repeater1.DataBind();
        }

        catch(Exception error)

        {
            Response.Write(error.ToString());
        }

    }

    protected void AspNetPager1_PageChanging(object src, Wuqi.Webdiyer.PageChangingEventArgs e)

    {
        this.AspNetPager1.CurrentPageIndex = e.NewPageIndex;
        DepeaterDataBind();
    }

}

【“AspNetPager1_PageChanging”的重载均与委托“System.EventHandler”不匹配↓】

　　Default.aspx.cs

　　protected void AspNetPager1_PageChanging(object src, Wuqi.Webdiyer.PageChangingEventArgs e)
    {
        this.AspNetPager1.CurrentPageIndex = e.NewPageIndex;
        DepeaterDataBind();
    }

　　Default.aspx

　　错误：<webdiyer:AspNetPager ID="AspNetPager1" runat="server" UrlPaging="True" onpagechanged="AspNetPager1_PageChanging"></webdiyer:AspNetPager>

　　正确：<webdiyer:AspNetPager ID="AspNetPager1" runat="server" UrlPaging="True" onpagechanging="AspNetPager1_PageChanging"></webdiyer:AspNetPager>

AspNetPager不显示的N种可能性↓

1、要分页的记录总数只要一页且AlwaysShow设为false（默认）；
2、Visible属性设为false；
3、未设置RecordCount值。这个可能是主要原因！！
(补充：设置RecordCount值的方法是)
AspNetPager1.RecordCount 所有满足条件的值

分页是Web应用程序中最常用到的功能之一，在ASP.NET中，虽然自带了一个可以分页的DataGrid（asp.net 1.1）和GridView（asp.net 2.0）控件，但其分页功能并不尽如人意，如可定制性差、无法通过Url实现分页功能等，而且有时候我们需要对DataList和Repeater甚至自定义数据绑定控件进行分页，手工编写分页代码不但技术难度大、任务繁琐而且代码重用率极低，因此分页已成为许多ASP.NET程序员最头疼的问题之一。
AspNetPager针对ASP.NET分页控件的不足，提出了与众不同的解决asp.net中分页问题的方案，即将分页导航功能与数据显示功能完全独立开来，由用户自己控制数据的获取及显示方式，因此可以被灵活地应用于任何需要实现分页导航功能的地方，如为GridView、DataList以及Repeater等数据绑定控件实现分页、呈现自定义的分页数据以及制作图片浏览程序等，因为AspNetPager控件和数据是独立的，因此要分页的数据可以来自任何数据源，如SQL Server、Oracle、Access、mysql、DB2等数据库以及XML文件、内存数据或缓存中的数据、文件系统等等。

AspNetPager 7.2 版发布
新增属性 PagingButtonLayoutType，可设置分页导航元素（数字页索引、上页、下页、首页和尾页）的布局方式，该属性值是一个PagingButtonLayoutType枚举，通过设置该属性为PagingButtonLayoutType.UnorderedList或PagingButtonLayoutType.Span，允许将这些分页导航元素包含在<li>与</li>或<span>与</span>标签之间，以便于为这些分页元素应用CSS样式。
新增 PagingButtonClass 与 PagingButtonStyle 属性，可以单独为分页导航按钮（数字页索引、上页、下页、首页和尾页）设置CSS样式；
新增 FirstLastButtonClass 与 FirstLastButtonStyle 属性，可以单独为首页和尾页分页导航按钮设置CSS样式，如果该属性未设置，但指定了PagingButtonClass 与 PagingButtonStyle 属性的值，则首页和尾页按钮样式将使用 PagingButtonClass 与 PagingButtonStyle 属性中指定的样式；
新增 NextPrevButtonClass 与 NextPrevButtonStyle 属性，可以单独为上页和下页分页导航按钮设置CSS样式，如果该属性未设置，但指定了PagingButtonClass 与 PagingButtonStyle 属性的值，则上页和下页按钮样式将使用 PagingButtonClass 与 PagingButtonStyle 属性中指定的样式；
新增 MoreButtonClass 与 MoreButtonStyle 属性，可以单独为更多页（...）分页导航按钮设置CSS样式，如果该属性未设置，但指定了PagingButtonClass 与 PagingButtonStyle 属性的值，则上页和下页按钮样式将使用 PagingButtonClass 与 PagingButtonStyle 属性中指定的样式；
新增属性 ShowMoreButtons ，可以指定是否显示更多页按钮；
新增属性 CurrentPageButtonPosition ，可设置在每次分页后，当前页数字索引在所有的数字页索引中的显示位置，该属性值是一个PagingButtonPosition枚举，对应的值及说明如下：
Beginning：当前页数字索引总是显示在所有数字页索引的最前面；
End：当前页数字索引总是显示在所有数字页索引的最后面；
Center：当前页数字索引总是显示在所有数字页索引的中间；
Fixed：默认值，固定不变；
控件的CssClass属性仅应用于控件的窗口元素（div），将不再应用于下属分页元素；
废止属性CenterCurrentPageButton，可以用CurrentPageButtonPosition属性取代；
修改CurrentPageIndexn属性，允许在程序中任何地方以编程方式设置CurrentPageIndex的值来动态指定当前页，直接设置该属性的值时将同时引发PageChanging和PageChanged 事件，实现和点击分页按钮一样的分页功能；
修正了7.1版中设置SubmitButtonImageUrl属性后，Postback回发分页方式情况下点击数字页索引按钮不引发分页事件的bug；
修正了使用Url分页时，如果页面上没有服务器端form控件时无法注册客户端脚本的bug，从7.2版起如果使用Url分页并且ShowPageIndexBox属性没有设置为Never时， AspNetPager控件必须放在<form runat="server">与</form>标记之间，若使用Url分页并且ShowPageIndexBox为Never时，页面上可以不使用服务器端form控件。
AspNetPager的主要功能：
1、支持通过Url进行分页：
AspNetPager除提供默认的类似于DataGrid和GridView的PostBack分页方式外，还支持通过Url进行分页，象大多数asp程序中分页一样， Url分页方式允许用户通过在浏览器地址栏中输入相应的地址即可直接进入指定页面，也可以使搜索引擎搜索到所有分页的页面的内容，因此具有用户友好和搜索引擎友好的优点，关于Url分页与PostBack分页方式的差异，请参考Url与PostBack分页方式的对比。
2、支持Url分页方式下的Url重写（UrlRewrite）功能
Url重写技术可以使显示给用户的Url不同于实际的Url，Url重写技术被广泛应用于搜索引擎优化（SEO）、网站重组后重定向页面路径以及提供用户友好的Url等方面， AspNetPager支持Url重写技术使您可以自定义分页导航的Url格式，实现Url重写；
3、支持使用用户自定义图片做为导航元素：
您可以使用自定义的图片文件做为分页控件的导航元素，而不仅仅限于显示文字内容。
4、功能强大灵活、使用方便、可定制性强：
AspNetPager分页控件的所有导航元素都可以由用户进行单独控制，从6.0版起，AspNetPager支持使用主题（Theme）与皮肤（Skin）统一控件的整体样式，配合asp.net 2.0中的DataSource控件，AspNetPager只需要编写短短几行代码，甚至无需编写任何代码，只需设置几个属性就可以实现分页功能。
5、增强的 Visual Studio 2005/2008设计时支持
增强的设计时支持使控件在设计时更加直观，易于使用，开发快捷方便。
6、兼容IE6.0+及FireFox 1.5+等浏览器
7、丰富而完整的控件文档和示例项目：
控件附带的完整的帮助文档及示例项目能够帮助您快速上手，熟悉AspNetPager控件的使用，您还可以通过给作者留言以及论坛提问等方式解决控件使用中遇到的问题。