1、工程和项目结构
本文示例主要就是通过IBatisNet进行一个简单的数据查询。
2、分页控件
(1)、分页效果图
在DotNet.Common下的DotNet.Common.WinForm工程下有一个用户控件PagerControl,它的设计视图主要包括四个LinkLabel、一个数字文本框、一个Button控件以及几个和显示统计数字相关的Label控件。本文示例的一个分页显示效果如下:
控件比较丑陋,是多么没有美术和设计天赋啊。
(2)、控件使用方式
1
2
3
4
|
//绑定页码相关信息
PagerControl pager =
new
PagerControl(
this
.CurrentPage,
this
.RecordsPerPage,
this
.TotalCount,
"跳转"
);
pager.currentPageChanged +=
new
EventHandler(pager_currentPageChanged);
//页码变化 触发的事件
this
.panelPager.Controls.Add(pager);
//在Panel容器中加入这个控件
|
使用这个控件的时候,只需要简单的new一个控件对象,然后传入正确的参数,如当前页面,每页记录数,数据集合总记录数以及按钮上显示的文字即可。
(3)、如何正确传参和分页
对于分页来说,重要的是传入查询条件和页码参数。查询条件我们的MainForm窗体有现成的输入文本框,那么如何传递当前页码参数呢?毫无疑问,4个LinkLabel以及一个数字输入框和一个按钮组合会引发当前页数字的改变,所以我们要在它们所对应的一些事件下做一些CurrentPage的处理:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
|
#region 相关控件事件
private
void
lnkFirst_LinkClicked(
object
sender, LinkLabelLinkClickedEventArgs e)
{
CurrentPage = 1;
DrawControl();
}
private
void
lnkPrev_LinkClicked(
object
sender, LinkLabelLinkClickedEventArgs e)
{
CurrentPage = Math.Max(1, CurrentPage - 1);
DrawControl();
}
private
void
lnkNext_LinkClicked(
object
sender, LinkLabelLinkClickedEventArgs e)
{
CurrentPage = Math.Min(PageCount, CurrentPage + 1);
DrawControl();
}
private
void
lnkLast_LinkClicked(
object
sender, LinkLabelLinkClickedEventArgs e)
{
CurrentPage = PageCount;
DrawControl();
}
/// <summary>
/// enter键功能
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private
void
txtPageNum_KeyPress(
object
sender, KeyPressEventArgs e)
{
string
strNum =
this
.txtPageNum.Text.Trim();
if
(e.KeyChar == (
char
)Keys.Enter && RegUtil.IsPositiveNumber(strNum))
{
CurrentPage =
int
.Parse(strNum);
DrawControl();
}
}
/// <summary>
/// 页数限制
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private
void
txtPageNum_TextChanged(
object
sender, EventArgs e)
{
string
strNum =
this
.txtPageNum.Text.Trim();
if
(strNum.Length > 0 && RegUtil.IsPositiveNumber(strNum) &&
int
.Parse(strNum) > PageCount)
{
txtPageNum.Text = PageCount.ToString();
}
}
/// <summary>
/// 跳转
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private
void
btnGo_Click(
object
sender, EventArgs e)
{
string
strNum =
this
.txtPageNum.Text.Trim();
if
(RegUtil.IsPositiveNumber(strNum) ==
false
)
{
return
;
}
CurrentPage =
int
.Parse(strNum);
DrawControl();
}
#endregion
|
我们注意到DrawControl方法,这是非常重要的一个函数:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
|
/// <summary>
/// 页面控件呈现
/// </summary>
private
void
DrawControl()
{
this
.btnGo.Text =
this
.JumpText;
this
.lblCurrentPage.Text = CurrentPage.ToString();
this
.lblPageCount.Text = PageCount.ToString();
this
.lblTotalCount.Text = TotalCount.ToString();
this
.lblRecPerPg.Text = RecordsPerPage.ToString();
if
(currentPageChanged !=
null
)
{
currentPageChanged(
this
,
null
);
//当前分页数字改变时,触发委托事件
}
SetFormCtrEnabled();
if
(PageCount == 1)
//有且仅有一页
{
this
.lnkFirst.Enabled =
false
;
this
.lnkPrev.Enabled =
false
;
this
.lnkNext.Enabled =
false
;
this
.lnkLast.Enabled =
false
;
this
.btnGo.Enabled =
false
;
}
else
if
(CurrentPage == 1)
//第一页
{
this
.lnkFirst.Enabled =
false
;
this
.lnkPrev.Enabled =
false
;
//this.lnkFirst.ForeColor = Color.Gray;
//this.lnkPrev.ForeColor = Color.Gray;
}
else
if
(CurrentPage ==
this
.PageCount)
//最后一页
{
this
.lnkNext.Enabled =
false
;
this
.lnkLast.Enabled =
false
;
}
}
|
因为它会有条件地触发下面的委托事件:
1
|
public
event
EventHandler currentPageChanged;
|
我们完全可以这样理解:当我们点击按钮或者LinkLabel的时候,当前页码发生改变,所以需要重新做一些事情比如查询等等。控件就是通过引发currentPageChanged事件来触发的:
1
2
3
4
|
if
(currentPageChanged !=
null
)
{
currentPageChanged(
this
,
null
);
//当前分页数字改变时,触发委托事件
}
|
至于currentPageChanged委托触发的时候具体要做什么,那是每一个具体窗体中的函数要做的事情。比如本文的demo中,在MainForm中,我们通过定义下面这个方法给pager的currentPageChanged赋值:
1
2
3
4
5
6
7
8
9
|
private
void
pager_currentPageChanged(
object
sender, EventArgs e)
{
PagerControl pager = sender
as
PagerControl;
if
(pager ==
null
)
{
return
;
}
BindResults(pager.CurrentPage);
//查询数据并分页绑定
}
|
当分页控件的事件委托触发的时候,这里的BindResults函数通过pager的当前页数进行查询和数据绑定。这样说也许对你通俗地理解委托和事件有好处。
总体来说,实现winform的分页效果比webform要简单一些,因为它不需要考虑某些参数状态的变化。
本文转自JeffWong博客园博客,原文链接:http://www.cnblogs.com/jeffwongishandsome/archive/2010/11/21/1883160.html,如需转载请自行联系原作者