原创企业级控件库之大数据量分页控件

原创企业级控件库之大数据量分页控件

在上篇：我介绍了原创企业级控件库之组合查询控件，这篇我将给大家介绍：企业级控件库之大数据量分页控件。 　  摘要 说到分页，大家采用的方法各有千秋，分页在一个中大型软件项目中对数据的快速呈现起到很关键的作用，试想一个数据量上几十万或者几百万的数据表，要是没有分页功能会是一个什么样的效果。总的说来，大家采用的分页方法大同小异，但到底那种方法才是最佳的呢，各有各的看法，让数据说话最有效。今天我给大家分享一个WinForm下大数据量分页控件（当然分页思想也可用于WebForm）。虽然不能说是最佳的，但在我的几个实际项目中，用的都是它，效果不错，可放心使用。 　  成就别人、等于成就自己。我没什么要求，欢迎大家多多支持与评论，觉得不错的，记得点击文章左下角的”关注博客”，就这么简单。同时，你要用什么好的想法，也可以与我交流，谢谢。 分页控件运行效果如下图： 　　用到的分页存储过程:  [code lang="sql"] -- ============================================= -- Author: EricHu QQ:406590790 WebSite:http://www.cnblogs.com/huyong/ -- Create date: 2008-10-25 -- Description: 千万数量级分页存储过程 -- Modify Date: 2010-10-26 -- ============================================= SET ANSI_NULLS ON GO SET QUOTED_IDENTIFIER ON GO ALTERPROCEDURE[dbo].[uspDividePage] /* *************************************************************** ** 千万数量级分页存储过程** *************************************************************** 参数说明: 1.Tables :表名或视图名 2.PrimaryKey :主关键字 3.Sort :排序语句，不带Order By 比如：UserId Desc,CreateDate Asc 4.CurrentPage :当前页码 5.PageSize :分页尺寸 6.Fields :字段列表(默认为:*) 7.Filter :过滤语句，不带Where 8.Group :Group语句,不带Group By ***************************************************************/ ( @Tablesvarchar(2000), @PrimaryKeyvarchar(500), @Sortvarchar(500) =NULL, @CurrentPageint=1, @PageSizeint=10, @Fieldsvarchar(2000) ='*', @Filtervarchar(1000) =NULL, @Groupvarchar(1000) =NULL ) AS /*默认排序*/ [email protected]@Sort='' [email protected][email protected] [email protected](1000) [email protected](1000) [email protected](1000) [email protected](2) [email protected](1000) [email protected] /*设定排序语句.*/ IFCHARINDEX('DESC',@Sort)>0 BEGIN [email protected]=REPLACE(@Sort, 'DESC', '') [email protected]='<=' END ELSE BEGIN IFCHARINDEX('ASC', @Sort) =0 [email protected]=REPLACE(@Sort, 'ASC', '') [email protected]='>=' END IFCHARINDEX('.', @strSortColumn) >0 BEGIN [email protected]=SUBSTRING(@strSortColumn, 0, CHARINDEX('.',@strSortColumn)) [email protected]=SUBSTRING(@strSortColumn, CHARINDEX('.',@strSortColumn) +1, LEN(@strSortColumn)) END ELSE BEGIN [email protected][email protected] [email protected][email protected] END [email protected]=t.name, @prec=c.prec FROM sysobjects o JOIN syscolumns c on o.id=c.id JOIN systypes t on c.xusertype=t.xusertype WHERE o.name [email protected] c.name [email protected] IFCHARINDEX('char', @type) >0 [email protected][email protected]+'('+CAST(@precASvarchar) +')' [email protected](500) [email protected](500) [email protected](1000) [email protected](1000) [email protected](1000) /*默认当前页*/ [email protected]<1 [email protected]=1 /*设置分页参数.*/ [email protected]=CAST(@PageSizeASvarchar(500)) [email protected]=CAST(((@CurrentPage-1)[email protected]+1) ASvarchar(500)) /*筛选以及分组语句.*/ [email protected]@Filter!='' BEGIN [email protected]=' WHERE [email protected]+'' [email protected]=' AND [email protected]+'' END ELSE BEGIN [email protected]='' [email protected]='' END [email protected]@Group!='' [email protected]=' GROUP BY [email protected]+'' ELSE [email protected]='' /*执行查询语句*/ EXEC( ' DECLARE @SortColumn [email protected]+' SET ROWCOUNT [email protected]+' SELECT @[email protected]+' FROM [email protected][email protected][email protected]+' ORDER BY [email protected]+' SET ROWCOUNT [email protected]+' SELECT [email protected]+' FROM [email protected]+' WHERE [email protected][email protected]+' @SortColumn [email protected][email protected]+' ORDER BY [email protected]+' ') GO SET ANSI_NULLS OFF GO SET QUOTED_IDENTIFIER OFF GO　 [/code] 　　本控件类图　　 　　 本控件UcpageControl类详细信息 　　 本控件PageData类详细信息 　　 本控件核心代码 一、数据源提供类PageData,主要负责与存储过程进行交互。 [code lang="csharp"] /// <summary> /// 数据源提供 /// /// 修改记录： /// 2010-12-19 胡勇 修改int GetTotalCount(string connectionstring)方法 /// 当查询条件为空时，高效得到指定表的记录总数。 /// </summary> public class PageData { DataSet ds = null; private int _PageSize = 50; //分页大小 private int _PageIndex = 1; //当前页 private int _PageCount = 0; //总页数 private int _TotalCount = 0; //总记录数 private string _QueryFieldName = "*"; //表字段FieldStr private bool _isQueryTotalCounts = true; //是否查询总的记录条数 private string _TableName = string.Empty; //表名 private string _OrderStr = string.Empty; //排序_SortStr private string _QueryCondition = string.Empty; //查询的条件 RowFilter private string _PrimaryKey = string.Empty; //主键 /// <summary> /// 是否查询总的记录条数 /// </summary> public bool IsQueryTotalCounts { get { return _isQueryTotalCounts; } set { _isQueryTotalCounts = value; } } /// <summary> /// 分页大小(每页显示多少条数据) /// </summary> public int PageSize { get { return _PageSize; } set { _PageSize = value; } } /// <summary> /// 当前页 /// </summary> public int PageIndex { get { return _PageIndex; } set { _PageIndex = value; } } /// <summary> /// 总页数 /// </summary> public int PageCount { get { return _PageCount; } } /// <summary> /// 总记录数 /// </summary> public int TotalCount { get { return _TotalCount; } } /// <summary> /// 表名或视图名 /// </summary> public string TableName { get { return _TableName; } set { _TableName = value; } } /// <summary> /// 表字段FieldStr /// </summary> public string QueryFieldName { get { return _QueryFieldName; } set { _QueryFieldName = value; } } /// <summary> /// 排序字段 /// </summary> public string OrderStr { get { return _OrderStr; } set { _OrderStr = value; } } /// <summary> /// 查询条件 /// </summary> public string QueryCondition { get { return _QueryCondition; } set { _QueryCondition = value; } } /// <summary> /// 主键 /// </summary> public string PrimaryKey { get { return _PrimaryKey; } set { _PrimaryKey = value; } } /// <summary> /// 得到分页数据 /// </summary> /// <param name="connectionstring">连接字符串</param> /// <returns>DataSet</returns> public DataSet QueryDataTable(string connectionstring) { SqlParameter[] parameters = { new SqlParameter("@Tables", SqlDbType.VarChar, 255), new SqlParameter("@PrimaryKey" , SqlDbType.VarChar , 255), new SqlParameter("@Sort", SqlDbType.VarChar , 255), new SqlParameter("@CurrentPage", SqlDbType.Int ), new SqlParameter("@PageSize", SqlDbType.Int ), new SqlParameter("@Fields", SqlDbType.VarChar, 255), new SqlParameter("@Filter", SqlDbType.VarChar, 1000), new SqlParameter("@Group" , SqlDbType.VarChar, 1000) }; parameters[0].Value = _TableName; parameters[1].Value = _PrimaryKey; parameters[2].Value = _OrderStr; parameters[3].Value = PageIndex; parameters[4].Value = PageSize; parameters[5].Value =_QueryFieldName; parameters[6].Value = _QueryCondition; parameters[7].Value = string.Empty; ds = null; ds = new DataSet(); ds = DbHelperSQL.RunProcedure(connectionstring, "uspDividePage", parameters, "tbPageData"); if (_isQueryTotalCounts) { _TotalCount = GetTotalCount(connectionstring); } if (_TotalCount == 0) { _PageIndex = 0; _PageCount = 0; } else { _PageCount = _TotalCount % _PageSize == 0 ? _TotalCount / _PageSize : _TotalCount / _PageSize + 1; if (_PageIndex > _PageCount) { _PageIndex = _PageCount; parameters[4].Value = _PageSize; ds = QueryDataTable(connectionstring); } } return ds; } /// <summary> /// 得到总的记录数 /// </summary> /// <param name="connectionstring">连接字符串</param> /// <returns>总的记录数</returns> public int GetTotalCount(string connectionstring) { //string strSql = " select count(1) from "+_TableName; //if (_QueryCondition != string.Empty) //{ // strSql += " where " + _QueryCondition; //} string strSql = ""; if (_QueryCondition != string.Empty) { strSql = " select count(1) from " + _TableName + " where " + _QueryCondition; ; } else { strSql = "select rows from sys.sysindexes where id = object_id('" + _TableName + "') and indid in (0,1) ";//当查询条件为空时，高效得到记录总数 } return Convert.ToInt32(DbHelperSQL.GetSingle(strSql.ToString(), connectionstring)); } [/code] 　　 窗体调用方法 一、设置窗体调用公共方法。 二、在控件的EventPaging事件代码中调用即可。 三、SqlServer测试数据代码如下：         下面给出本控件完整代码 [code lang="csharp"] #region 版权信息 /*---------------------------------------------------------------------* // Copyright (C) 2010 http://www.cnblogs.com/huyong // 版权所有。 // 项目 名称：《Winform通用控件库》 // 文 件 名： UcPageControl.cs // 类 全 名： DotNet.Controls.UcPageControl // 描 述: 分页控件 // 创建 时间： 2010-06-05 // 创建人信息： [**** 姓名:胡勇 QQ:80368704 E-Mail:[email protected] *****] *----------------------------------------------------------------------*/ #endregion using System; using System.Collections.Generic; using System.ComponentModel; using System.Drawing; using System.Data; using System.Data.SqlClient; using System.Windows.Forms; using DotNet.Common; using DotNet.DBUtility; namespace DotNet.Controls { #region 委托申明 /// <summary> /// 申明委托 /// </summary> /// <param name="e"></param> /// <returns></returns> public delegate int EventPagingHandler(EventPagingArg e); #endregion #region 分页控件 /// <summary> /// 分页控件 /// /// 修改纪录(此分页控件经过多次修改，已趋于完美，可放心使用。) /// 2010-12-06 胡勇 对上一条、下一条、首条、末条数据导航的隐藏，因为控件本身已做了处理。 /// 2010-12-05 胡勇 对分页控件代码做了相应优化 /// 2010-06-05 胡勇 创建分页控件 /// /// <author> /// <name>胡勇</name> /// <QQ>80368704</QQ> /// <Email>[email protected]</Email> /// </author> /// </summary> [ToolboxItem(true)] [DefaultEvent("EventPaging")] [ToolboxBitmap(typeof(UcPageControl), "Images.UcPageControlIcon.png")] [Description("分页控件")] public partial class UcPageControl : UserControl { #region 申明事件 /// <summary> /// 单击移动到当前页上一末记录时发生 /// </summary> [Category("数据分页"), Description("单击移动到当前页上一末记录时发生。"),Browsable(false)] public event EventHandler OnBindingNavigatorMovePreviousItemClick; /// <summary> /// 单击移动到当前页第一条记录时发生 /// </summary> [Category("数据分页"), Description("单击移动到当前页第一条记录时发生。"), Browsable(false)] public event EventHandler OnBindingNavigatorMoveFirstItemClick; /// <summary> /// 单击移动到当前页下一条记录时发生 /// </summary> [Category("数据分页"), Description("单击移动到当前页下一条记录时发生。"), Browsable(false)] public event EventHandler OnBindingNavigatorMoveNextItemClick; /// <summary> /// 单击移动到当前页最后一条记录时发生 /// </summary> [Category("数据分页"), Description("单击移动到当前页最后一条记录时发生。"), Browsable(false)] public event EventHandler OnBindingNavigatorMoveLastItemClick; /// <summary> /// 单击各分页按钮(上一页、下一页、第一页、最后一页和转到某页)时发生 /// </summary> [Category("数据分页"), Description("分页时发生。")] public event EventPagingHandler EventPaging; #endregion #region 构造函数 public UcPageControl() { InitializeComponent(); } #endregion #region 属性 private int _pageSize = 50; //每页显示记录数 private int _nMax = 0; //总记录数 private int _pageCount = 0; //页数=总记录数/每页显示记录数 private int _pageCurrent = 0; //当前页号 /// <summary> /// 每页显示记录数 /// </summary> [Category("数据分页"), Description("每页显示记录数。"), Browsable(false)] public int PageSize { get { return _pageSize; } set { _pageSize = value; GetPageCount();//页数 } } /// <summary> /// 记录总数 /// </summary> [Category("数据分页"), Description("记录总数。"),Browsable(false)] public int NMax { get { return _nMax; } set { _nMax = value; GetPageCount(); } } /// <summary> /// 页数 /// </summary> [Category("数据分页"), Description("页数。"), Browsable(false)] public int PageCount { get { return _pageCount; } set { _pageCount = value; } } /// <summary> /// 当前页号 /// </summary> [Category("数据分页"), Description("当前页号。"), Browsable(false)] public int PageCurrent { get { return _pageCurrent; } set { _pageCurrent = value; } } #endregion #region 方法 [Category("数据分页"), Description("bindingNavigator。"), Browsable(false)] public BindingNavigator ToolBar { get { return this.bindingNavigator; } } /// <summary> /// 得到总页数 /// </summary> private void GetPageCount() { if (this.NMax > 0) { this.PageCount = Convert.ToInt32(Math.Ceiling(Convert.ToDouble(this.NMax) / Convert.ToDouble(this.PageSize))); } else { this.PageCount = 0; } } /// <summary> /// 绑定分页控件(关键代码) /// </summary> public void Bind() { if (this.EventPaging != null) { this.NMax = this.EventPaging(new EventPagingArg(this.PageCurrent)); } if (this.PageCurrent > this.PageCount) { this.PageCurrent = this.PageCount; } if (this.PageCount == 1) { this.PageCurrent = 1; } lblPageCount.Text = this.PageCount.ToString(); this.lblMaxPage.Text = "共"+this.NMax.ToString()+"条记录"; this.txtCurrentPage.Text = this.PageCurrent.ToString(); if (this.PageCurrent == 1) { this.btnPrev.Enabled = false; this.btnFirst.Enabled = false; } else { btnPrev.Enabled = true; btnFirst.Enabled = true; } if (this.PageCurrent == this.PageCount) { this.btnLast.Enabled = false; this.btnNext.Enabled = false; } else { btnLast.Enabled = true; btnNext.Enabled = true; } if (this.NMax == 0) { btnNext.Enabled = false; btnLast.Enabled = false; btnFirst.Enabled = false; btnPrev.Enabled = false; } } #endregion #region 按钮事件 private void btnFirst_Click(object sender, EventArgs e) { PageCurrent = 1; this.Bind(); } private void btnPrev_Click(object sender, EventArgs e) { PageCurrent -= 1; if (PageCurrent <= 0) { PageCurrent = 1; } this.Bind(); } private void btnNext_Click(object sender, EventArgs e) { this.PageCurrent += 1; if (PageCurrent > PageCount) { PageCurrent = PageCount; } this.Bind(); } private void btnLast_Click(object sender, EventArgs e) { PageCurrent = PageCount; this.Bind(); } private void btnGo_Click(object sender, EventArgs e) { if (this.txtCurrentPage.Text != null && txtCurrentPage.Text != "") { if (Int32.TryParse(txtCurrentPage.Text, out _pageCurrent)) { this.Bind(); } else { DialogHelper.ShowErrorMsg("输入数字格式错误！"); } } } private void txtCurrentPage_KeyDown(object sender, KeyEventArgs e) { if (e.KeyCode == Keys.Enter) { this.Bind(); } } private void bindingNavigatorMovePreviousItem_Click(object sender, EventArgs e) { if(OnBindingNavigatorMovePreviousItemClick != null) { OnBindingNavigatorMovePreviousItemClick(this, null); } } private void bindingNavigatorMoveFirstItem_Click(object sender, EventArgs e) { if (OnBindingNavigatorMoveFirstItemClick != null) { OnBindingNavigatorMoveFirstItemClick(this, null); } } private void bindingNavigatorMoveNextItem_Click(object sender, EventArgs e) { if (OnBindingNavigatorMoveNextItemClick != null) { OnBindingNavigatorMoveNextItemClick(this, null); } } private void bindingNavigatorMoveLastItem_Click(object sender, EventArgs e) { if (OnBindingNavigatorMoveLastItemClick != null) { OnBindingNavigatorMoveLastItemClick(this, null); } } #endregion } #endregion #region 自定义事件数据基类 /// <summary> /// 自定义事件数据基类 /// </summary> public class EventPagingArg : EventArgs { private int _intPageIndex; public EventPagingArg(int PageIndex) { _intPageIndex = PageIndex; } } #endregion #region 数据源提供(PageData) /// <summary> /// 数据源提供 /// /// 修改记录： /// 2010-12-19 胡勇 修改int GetTotalCount(string connectionstring)方法 /// 当查询条件为空时，高效得到指定表的记录总数。 /// </summary> public class PageData { DataSet ds = null; private int _PageSize = 50; //分页大小 private int _PageIndex = 1; //当前页 private int _PageCount = 0; //总页数 private int _TotalCount = 0; //总记录数 private string _QueryFieldName = "*"; //表字段FieldStr private bool _isQueryTotalCounts = true; //是否查询总的记录条数 private string _TableName = string.Empty; //表名 private string _OrderStr = string.Empty; //排序_SortStr private string _QueryCondition = string.Empty; //查询的条件 RowFilter private string _PrimaryKey = string.Empty; //主键 /// <summary> /// 是否查询总的记录条数 /// </summary> public bool IsQueryTotalCounts { get { return _isQueryTotalCounts; } set { _isQueryTotalCounts = value; } } /// <summary> /// 分页大小(每页显示多少条数据) /// </summary> public int PageSize { get { return _PageSize; } set { _PageSize = value; } } /// <summary> /// 当前页 /// </summary> public int PageIndex { get { return _PageIndex; } set { _PageIndex = value; } } /// <summary> /// 总页数 /// </summary> public int PageCount { get { return _PageCount; } } /// <summary> /// 总记录数 /// </summary> public int TotalCount { get { return _TotalCount; } } /// <summary> /// 表名或视图名 /// </summary> public string TableName { get { return _TableName; } set { _TableName = value; } } /// <summary> /// 表字段FieldStr /// </summary> public string QueryFieldName { get { return _QueryFieldName; } set { _QueryFieldName = value; } } /// <summary> /// 排序字段 /// </summary> public string OrderStr { get { return _OrderStr; } set { _OrderStr = value; } } /// <summary> /// 查询条件 /// </summary> public string QueryCondition { get { return _QueryCondition; } set { _QueryCondition = value; } } /// <summary> /// 主键 /// </summary> public string PrimaryKey { get { return _PrimaryKey; } set { _PrimaryKey = value; } } /// <summary> /// 得到分页数据 /// </summary> /// <param name="connectionstring">连接字符串</param> /// <returns>DataSet</returns> public DataSet QueryDataTable(string connectionstring) { SqlParameter[] parameters = { new SqlParameter("@Tables", SqlDbType.VarChar, 255), new SqlParameter("@PrimaryKey" , SqlDbType.VarChar , 255), new SqlParameter("@Sort", SqlDbType.VarChar , 255), new SqlParameter("@CurrentPage", SqlDbType.Int ), new SqlParameter("@PageSize", SqlDbType.Int ), new SqlParameter("@Fields", SqlDbType.VarChar, 255), new SqlParameter("@Filter", SqlDbType.VarChar, 1000), new SqlParameter("@Group" , SqlDbType.VarChar, 1000) }; parameters[0].Value = _TableName; parameters[1].Value = _PrimaryKey; parameters[2].Value = _OrderStr; parameters[3].Value = PageIndex; parameters[4].Value = PageSize; parameters[5].Value =_QueryFieldName; parameters[6].Value = _QueryCondition; parameters[7].Value = string.Empty; ds = null; ds = new DataSet(); ds = DbHelperSQL.RunProcedure(connectionstring, "uspDividePage", parameters, "tbPageData"); if (_isQueryTotalCounts) { _TotalCount = GetTotalCount(connectionstring); } if (_TotalCount == 0) { _PageIndex = 0; _PageCount = 0; } else { _PageCount = _TotalCount % _PageSize == 0 ? _TotalCount / _PageSize : _TotalCount / _PageSize + 1; if (_PageIndex > _PageCount) { _PageIndex = _PageCount; parameters[4].Value = _PageSize; ds = QueryDataTable(connectionstring); } } return ds; } /// <summary> /// 得到总的记录数 /// </summary> /// <param name="connectionstring">连接字符串</param> /// <returns>总的记录数</returns> public int GetTotalCount(string connectionstring) { //string strSql = " select count(1) from "+_TableName; //if (_QueryCondition != string.Empty) //{ // strSql += " where " + _QueryCondition; //} string strSql = ""; if (_QueryCondition != string.Empty) { strSql = " select count(1) from " + _TableName + " where " + _QueryCondition; ; } else { strSql = "select rows from sys.sysindexes where id = object_id('" + _TableName + "') and indid in (0,1) ";//当查询条件为空时，高效得到记录总数 } return Convert.ToInt32(DbHelperSQL.GetSingle(strSql.ToString(), connectionstring)); } } #endregion } [/code]