原创企业级控件库之大数据量分页控件
发布日期:2010年12月18日星期六作者:EricHu
在上篇:我介绍了原创企业级控件库之组合查询控件,这篇我将给大家介绍:企业级控件库之大数据量分页控件。
摘要
说到分页,大家采用的方法各有千秋,分页在一个中大型软件项目中对数据的快速呈现起到很关键的作用,试想一个数据量上几十万或者几百万的数据表,要是没有分页功能会是一个什么样的效果。总的说来,大家采用的分页方法大同小异,但到底那种方法才是最佳的呢,各有各的看法,让数据说话最有效。今天我给大家分享一个WinForm下大数据量分页控件(当然分页思想也可用于WebForm)。虽然不能说是最佳的,但在我的几个实际项目中,用的都是它,效果不错,可放心使用。
成就别人、等于成就自己。我没什么要求,欢迎大家多多支持与评论,觉得不错的,记得点击文章左下角的”关注博客”,就这么简单。同时,你要用什么好的想法,也可以与我交流,谢谢。
分页控件运行效果如下图:
用到的分页存储过程:
1 -- =============================================
2 -- Author: EricHu QQ:80368704 WebSite:http://www.cnblogs.com/huyong/
3 -- Create date: 2008-10-25
4 -- Description: 千万数量级分页存储过程
5 -- Modify Date: 2010-10-26
6 -- =============================================
7
8 SET ANSI_NULLS ON
9 GO
10 SET QUOTED_IDENTIFIER ON
11 GO
12
13 ALTER PROCEDURE [ dbo ] . [ uspDividePage ]
14 /*
15 ***************************************************************
16 ** 千万数量级分页存储过程**
17 ***************************************************************
18 参数说明:
19 1.Tables :表名或视图名
20 2.PrimaryKey :主关键字
21 3.Sort :排序语句,不带Order By 比如:UserId Desc,CreateDate Asc
22 4.CurrentPage :当前页码
23 5.PageSize :分页尺寸
24 6.Fields :字段列表(默认为:*)
25 7.Filter :过滤语句,不带Where
26 8.Group :Group语句,不带Group By
27 ************************************************************** */
28 (
29 @Tables varchar ( 2000 ),
30 @PrimaryKey varchar ( 500 ),
31 @Sort varchar ( 500 ) = NULL ,
32 @CurrentPage int = 1 ,
33 @PageSize int = 10 ,
34 @Fields varchar ( 2000 ) = ' * ' ,
35 @Filter varchar ( 1000 ) = NULL ,
36 @Group varchar ( 1000 ) = NULL
37 )
38 AS
39 /* 默认排序 */
40 IF @Sort IS NULL OR @Sort = ''
41 SET @Sort = @PrimaryKey
42
43 DECLARE @SortTable varchar ( 1000 )
44 DECLARE @SortName varchar ( 1000 )
45 DECLARE @strSortColumn varchar ( 1000 )
46 DECLARE @operator char ( 2 )
47 DECLARE @type varchar ( 1000 )
48 DECLARE @prec int
49
50 /* 设定排序语句. */
51 IF CHARINDEX ( ' DESC ' , @Sort ) > 0
52 BEGIN
53 SET @strSortColumn = REPLACE ( @Sort , ' DESC ' , '' )
54 SET @operator = ' <= '
55 END
56 ELSE
57 BEGIN
58 IF CHARINDEX ( ' ASC ' , @Sort ) = 0
59 SET @strSortColumn = REPLACE ( @Sort , ' ASC ' , '' )
60 SET @operator = ' >= '
61 END
62
63 IF CHARINDEX ( ' . ' , @strSortColumn ) > 0
64 BEGIN
65 SET @SortTable = SUBSTRING ( @strSortColumn , 0 , CHARINDEX ( ' . ' , @strSortColumn ))
66 SET @SortName = SUBSTRING ( @strSortColumn , CHARINDEX ( ' . ' , @strSortColumn ) + 1 , LEN ( @strSortColumn ))
67 END
68 ELSE
69 BEGIN
70 SET @SortTable = @Tables
71 SET @SortName = @strSortColumn
72 END
73
74 SELECT @type = t.name, @prec = c.prec
75 FROM sysobjects o
76 JOIN syscolumns c on o.id = c.id
77 JOIN systypes t on c.xusertype = t.xusertype
78 WHERE o.name = @SortTable AND c.name = @SortName
79
80 IF CHARINDEX ( ' char ' , @type ) > 0
81 SET @type = @type + ' ( ' + CAST ( @prec AS varchar ) + ' ) '
82
83 DECLARE @strPageSize varchar ( 500 )
84 DECLARE @strStartRow varchar ( 500 )
85 DECLARE @strFilter varchar ( 1000 )
86 DECLARE @strSimpleFilter varchar ( 1000 )
87 DECLARE @strGroup varchar ( 1000 )
88 /* 默认当前页 */
89 IF @CurrentPage < 1
90 SET @CurrentPage = 1
91
92 /* 设置分页参数. */
93 SET @strPageSize = CAST ( @PageSize AS varchar ( 500 ))
94 SET @strStartRow = CAST ((( @CurrentPage - 1 ) * @PageSize + 1 ) AS varchar ( 500 ))
95
96 /* 筛选以及分组语句. */
97 IF @Filter IS NOT NULL AND @Filter != ''
98 BEGIN
99 SET @strFilter = ' WHERE ' + @Filter + ' '
100 SET @strSimpleFilter = ' AND ' + @Filter + ' '
101 END
102 ELSE
103 BEGIN
104 SET @strSimpleFilter = ''
105 SET @strFilter = ''
106 END
107
108 IF @Group IS NOT NULL AND @Group != ''
109 SET @strGroup = ' GROUP BY ' + @Group + ' '
110 ELSE
111 SET @strGroup = ''
112
113 /* 执行查询语句 */
114 EXEC (
115 '
116 DECLARE @SortColumn ' + @type + '
117 SET ROWCOUNT ' + @strStartRow + '
118 SELECT @SortColumn= ' + @strSortColumn + ' FROM ' + @Tables + @strFilter + ' ' + @strGroup + ' ORDER BY ' + @Sort + '
119 SET ROWCOUNT ' + @strPageSize + '
120 SELECT ' + @Fields + ' FROM ' + @Tables + ' WHERE ' + @strSortColumn + @operator + ' @SortColumn ' + @strSimpleFilter + ' ' + @strGroup + ' ORDER BY ' + @Sort + '
121 ' )
122 GO
123
124 SET ANSI_NULLS OFF
125 GO
126 SET QUOTED_IDENTIFIER OFF
127 GO
128
本控件类图
本控件UcpageControl类详细信息
本控件PageData类详细信息
本控件核心代码
一、数据源提供类PageData,主要负责与存储过程进行交互。
1 #region 数据源提供(PageData)
2 /// <summary>
3 /// 数据源提供
4 /// </summary>
5 public class PageData
6 {
7 DataSet ds = null ;
8 private int _PageSize = 50 ; // 分页大小
9 private int _PageIndex = 1 ; // 当前页
10 private int _PageCount = 0 ; // 总页数
11 private int _TotalCount = 0 ; // 总记录数
12 private string _QueryFieldName = " * " ; // 表字段FieldStr
13 private bool _isQueryTotalCounts = true ; // 是否查询总的记录条数
14 private string _TableName = string .Empty; // 表名
15 private string _OrderStr = string .Empty; // 排序_SortStr
16 private string _QueryCondition = string .Empty; // 查询的条件 RowFilter
17 private string _PrimaryKey = string .Empty; // 主键
18
19 /// <summary>
20 /// 是否查询总的记录条数
21 /// </summary>
22 public bool IsQueryTotalCounts
23 {
24 get { return _isQueryTotalCounts; }
25 set { _isQueryTotalCounts = value; }
26 }
27
28 /// <summary>
29 /// 分页大小(每页显示多少条数据)
30 /// </summary>
31 public int PageSize
32 {
33 get
34 {
35 return _PageSize;
36
37 }
38 set
39 {
40 _PageSize = value;
41 }
42 }
43
44 /// <summary>
45 /// 当前页
46 /// </summary>
47 public int PageIndex
48 {
49 get
50 {
51 return _PageIndex;
52 }
53 set
54 {
55 _PageIndex = value;
56 }
57 }
58
59 /// <summary>
60 /// 总页数
61 /// </summary>
62 public int PageCount
63 {
64 get
65 {
66 return _PageCount;
67 }
68 }
69
70 /// <summary>
71 /// 总记录数
72 /// </summary>
73 public int TotalCount
74 {
75 get
76 {
77 return _TotalCount;
78 }
79 }
80
81 /// <summary>
82 /// 表名或视图名
83 /// </summary>
84 public string TableName
85 {
86 get
87 {
88 return _TableName;
89 }
90 set
91 {
92 _TableName = value;
93 }
94 }
95
96 /// <summary>
97 /// 表字段FieldStr
98 /// </summary>
99 public string QueryFieldName
100 {
101 get
102 {
103 return _QueryFieldName;
104 }
105 set
106 {
107 _QueryFieldName = value;
108 }
109 }
110
111 /// <summary>
112 /// 排序字段
113 /// </summary>
114 public string OrderStr
115 {
116 get
117 {
118 return _OrderStr;
119 }
120 set
121 {
122 _OrderStr = value;
123 }
124 }
125
126 /// <summary>
127 /// 查询条件
128 /// </summary>
129 public string QueryCondition
130 {
131 get
132 {
133 return _QueryCondition;
134 }
135 set
136 {
137 _QueryCondition = value;
138 }
139 }
140
141 /// <summary>
142 /// 主键
143 /// </summary>
144 public string PrimaryKey
145 {
146 get
147 {
148 return _PrimaryKey;
149 }
150 set
151 {
152 _PrimaryKey = value;
153 }
154 }
155
156 /// <summary>
157 /// 得到分页数据
158 /// </summary>
159 /// <param name="connectionstring"> 连接字符串 </param>
160 /// <returns> DataSet </returns>
161 public DataSet QueryDataTable( string connectionstring)
162 {
163 SqlParameter[] parameters = {
164 new SqlParameter( " @Tables " , SqlDbType.VarChar, 255 ),
165 new SqlParameter( " @PrimaryKey " , SqlDbType.VarChar , 255 ),
166 new SqlParameter( " @Sort " , SqlDbType.VarChar , 255 ),
167 new SqlParameter( " @CurrentPage " , SqlDbType.Int ),
168 new SqlParameter( " @PageSize " , SqlDbType.Int ),
169 new SqlParameter( " @Fields " , SqlDbType.VarChar, 255 ),
170 new SqlParameter( " @Filter " , SqlDbType.VarChar, 1000 ),
171 new SqlParameter( " @Group " , SqlDbType.VarChar, 1000 )
172 };
173 parameters[ 0 ].Value = _TableName;
174 parameters[ 1 ].Value = _PrimaryKey;
175 parameters[ 2 ].Value = _OrderStr;
176 parameters[ 3 ].Value = PageIndex;
177 parameters[ 4 ].Value = PageSize;
178 parameters[ 5 ].Value = _QueryFieldName;
179 parameters[ 6 ].Value = _QueryCondition;
180 parameters[ 7 ].Value = string .Empty;
181 ds = null ;
182 ds = new DataSet();
183 ds = DbHelperSQL.RunProcedure(connectionstring, " uspDividePage " , parameters, " tbPageData " );
184
185 if (_isQueryTotalCounts)
186 {
187 _TotalCount = GetTotalCount(connectionstring);
188 }
189
190 if (_TotalCount == 0 )
191 {
192 _PageIndex = 0 ;
193 _PageCount = 0 ;
194 }
195 else
196 {
197 _PageCount = _TotalCount % _PageSize == 0 ? _TotalCount / _PageSize : _TotalCount / _PageSize + 1 ;
198
199 if (_PageIndex > _PageCount)
200 {
201 _PageIndex = _PageCount;
202 parameters[ 4 ].Value = _PageSize;
203 ds = QueryDataTable(connectionstring);
204 }
205 }
206
207 return ds;
208 }
209
210 /// <summary>
211 /// 得到总的记录数
212 /// </summary>
213 /// <param name="connectionstring"> 连接字符串 </param>
214 /// <returns> 总的记录数 </returns>
215 public int GetTotalCount( string connectionstring)
216 {
217 string strSql = " select count(1) from " + _TableName;
218
219 if (_QueryCondition != string .Empty)
220 {
221 strSql += " where " + _QueryCondition;
222 }
223
224 return Convert.ToInt32(DbHelperSQL.GetSingle(strSql.ToString(), connectionstring));
225 }
226 }
227 #endregion
窗体调用方法
一、设置窗体调用公共方法。
#region 绑定DataGridView
/// <summary>
/// 绑定DataGridView
/// </summary>
/// <param name="sTb"> 表名 </param>
/// <param name="sPk"> 主键 </param>
/// <param name="sOrderField"> 排序字段 </param>
/// <param name="sWhere"> 查询条件 </param>
/// <param name="sQueryFieldName"> 字段列表 </param>
/// <returns> 总记录数 </returns>
private int dgvBind( string sTb, string sPk, string sOrderField, string sWhere, string sQueryFieldName)
{
pageData = null ;
dtPub = null ;
pageData = new PageData();
dtPub = new DataTable();
pageData.TableName = sTb;
pageData.PrimaryKey = sPk;
pageData.OrderStr = sOrderField;
pageData.PageIndex = this .ucPageControlTest.PageCurrent;
pageData.PageSize = 200 ;
pageData.QueryCondition = sWhere;
pageData.QueryFieldName = sQueryFieldName;
dtPub = pageData.QueryDataTable(ConfigurationSettings.AppSettings[ " DbConnection " ]).Tables[ " tbPageData " ];
this .ucPageControlTest.bindingSource.DataSource = dtPub;
this .ucPageControlTest.bindingNavigator.BindingSource = ucPageControlTest.bindingSource;
dgvUcPageControlTest.DataSource = null ;
dgvUcPageControlTest.DataSource = this .ucPageControlTest.bindingSource;
if (dgvUcPageControlTest.Rows.Count > 0 )
{
dgvUcPageControlTest[ 4 , ucPageControlTest.bindingSource.Position].Selected = true ;
}
return pageData.TotalCount;
}
#endregion
二、在控件的EventPaging事件代码中调用即可。
return dgvBind("tbTestData", "UniqueID", "UniqueID", sQueryWhere, " * ");
三、SqlServer测试数据代码如下:
-- =============================================
-- Author: EricHu QQ:80368704 WebSite:http://www.cnblogs.com/huyong/
-- Create date: 2010-12-18
-- Description: 原创企业级控件库之大数据量分页控件---测试数据
-- Modify Date: 2010-12-18
-- =============================================
/* 一、创建数据库dbTest */
CREATE DATABASE dbTest
go
/* 二、创建数据表 */
USE [ dbTest ]
GO
CREATE TABLE [ dbo ] . [ tbTestData ] (
[ UniqueID ] [ bigint ] IDENTITY ( 20000 , 1 ) NOT NULL ,
[ CompanyName ] [ varchar ] ( 200 ) COLLATE Chinese_PRC_CI_AS NULL ,
[ CompanyCode ] [ varchar ] ( 50 ) COLLATE Chinese_PRC_CI_AS NULL ,
[ Address ] [ varchar ] ( 500 ) COLLATE Chinese_PRC_CI_AS NULL ,
[ Owner ] [ varchar ] ( 100 ) COLLATE Chinese_PRC_CI_AS NULL ,
[ Memo ] [ varchar ] ( 2000 ) COLLATE Chinese_PRC_CI_AS NULL ,
[ InsetDataTime ] [ datetime ] NULL CONSTRAINT [ DF_tbTestData_InsetDataTime ] DEFAULT ( getdate ()),
CONSTRAINT [ PK_tbTestData ] PRIMARY KEY CLUSTERED
(
[ UniqueID ] ASC
) WITH (IGNORE_DUP_KEY = OFF ) ON [ PRIMARY ]
) ON [ PRIMARY ]
GO
/* 三、增加测试数据 */
declare @count bigint
select @count = 1
while @count <= 5000000
begin
insert into tbTestData
values ( ' Company ' + cast ( @count as varchar ), ' CompanyCode ' + cast ( @count as varchar )
, ' Address ' + cast ( @count as varchar ), ' Owner ' + cast ( @count as varchar )
, ' Memo ' + cast ( @count as varchar ), getdate ())
select @count = @count + 1
end
下面给出本控件完整代码
1 #region 版权信息
2 /* ---------------------------------------------------------------------*
3 // Copyright (C) 2010 http://www.cnblogs.com/huyong
4 // 版权所有。
5 // 项目 名称:《Winform通用控件库》
6 // 文 件 名: UcPageControl.cs
7 // 类 全 名: DotNet.Controls.UcPageControl
8 // 描 述: 分页控件
9 // 创建 时间: 2010-06-05
10 // 创建人信息: [**** 姓名:胡勇 QQ:80368704 E-Mail:[email protected] *****]
11 *---------------------------------------------------------------------- */
12 #endregion
13
14 using System;
15 using System.Collections.Generic;
16 using System.ComponentModel;
17 using System.Drawing;
18 using System.Data;
19 using System.Data.SqlClient;
20 using System.Windows.Forms;
21 using DotNet.Common;
22 using DotNet.DBUtility;
23
24 namespace DotNet.Controls
25 {
26 #region 委托申明
27 /// <summary>
28 /// 申明委托
29 /// </summary>
30 /// <param name="e"></param>
31 /// <returns></returns>
32 public delegate int EventPagingHandler(EventPagingArg e);
33 #endregion
34
35 #region 分页控件
36 /// <summary>
37 /// 分页控件
38 ///
39 /// 修改纪录(此分页控件经过多次修改,已趋于完美,可放心使用。)
40 /// 2010-12-06 胡勇 对上一条、下一条、首条、末条数据导航的隐藏,因为控件本身已做了处理。
41 /// 2010-12-05 胡勇 对分页控件代码做了相应优化
42 /// 2010-06-05 胡勇 创建分页控件
43 ///
44 /// <author>
45 /// <name> 胡勇 </name>
46 /// <QQ> 80368704 </QQ>
47 /// <Email> [email protected] </Email>
48 /// </author>
49 /// </summary>
50 [ToolboxItem( true )]
51 [DefaultEvent( " EventPaging " )]
52 [ToolboxBitmap( typeof (UcPageControl), " DotNet.Controls.Images.UcPageControl.bmp " )]
53 [Description( " 分页控件 " )]
54 public partial class UcPageControl : UserControl
55 {
56 #region 申明事件
57 /// <summary>
58 /// 单击移动到当前页上一末记录时发生
59 /// </summary>
60 [Category( " 数据分页 " ), Description( " 单击移动到当前页上一末记录时发生。 " ),Browsable( false )]
61 public event EventHandler OnBindingNavigatorMovePreviousItemClick;
62
63 /// <summary>
64 /// 单击移动到当前页第一条记录时发生
65 /// </summary>
66 [Category( " 数据分页 " ), Description( " 单击移动到当前页第一条记录时发生。 " ), Browsable( false )]
67 public event EventHandler OnBindingNavigatorMoveFirstItemClick;
68
69 /// <summary>
70 /// 单击移动到当前页下一条记录时发生
71 /// </summary>
72 [Category( " 数据分页 " ), Description( " 单击移动到当前页下一条记录时发生。 " ), Browsable( false )]
73 public event EventHandler OnBindingNavigatorMoveNextItemClick;
74
75 /// <summary>
76 /// 单击移动到当前页最后一条记录时发生
77 /// </summary>
78 [Category( " 数据分页 " ), Description( " 单击移动到当前页最后一条记录时发生。 " ), Browsable( false )]
79 public event EventHandler OnBindingNavigatorMoveLastItemClick;
80
81 /// <summary>
82 /// 单击各分页按钮(上一页、下一页、第一页、最后一页和转到某页)时发生
83 /// </summary>
84 [Category( " 数据分页 " ), Description( " 分页时发生。 " )]
85 public event EventPagingHandler EventPaging;
86 #endregion
87
88 #region 构造函数
89 public UcPageControl()
90 {
91 InitializeComponent();
92 }
93 #endregion
94
95 #region 属性
96
97 private int _pageSize = 50 ; // 每页显示记录数
98 private int _nMax = 0<spa发表评论
评论