Winform分页控件更新之集成Sqlite数据库分页
在Winform开发中，一直离不开分页处理，好的分页控件封装，能为开发节省很多时间和繁琐工作，对分页控件一直的改进和完善，也是我的兴趣之一。分页控件一直都有一些小的更新，不过基本上已能满足大多数的使用场景了。有一天，一个朋友告诉我：我们项目用的是Sqlite数据库做项目，这个分页控件能支持实现分页吗？由于分页控件虽然不直接访问数据，不过需要根据不同的数据库来构造不同的分页语句，因为之前听说过但没怎么研究过Sqlite数据库，当然也没有提供支持了。
既然朋友需要，那就得研究下，并提供相关的支持，经过一番小修改，即可完成内容的Sqlite分页支持了。在给出相关的分页实现例子之前，我们介绍一下，为什么项目使用Sqlite而不是使用Access数据库，他们之间有那些特点。
1、Access特点
我们做小项目的时候特别是小的MIS系统一般也都要用数据库来保存数据，大部分的小系统都是用Access数据库，Access使用上确实非常方便，也方便对数据进行管理维护等优点，复制过去即可使用。但其实Access数据库本身也存在很多的问题：性能不行；数据不安全，用户可以直接用Access打开数据库文件进行数据修改，即使加密后都可以直接破解；Access的数据量一大，文件本身的体积就异常庞大；Access数据库文件很容易损坏等。
2、 SQLite特点
SQLite是一个小型的C程序库，实现了独立的，可嵌入的，零配置的SQL数据库引擎，SQLite用的非常广泛，Web应用也都在用它，PHP5内置了SQLite的扩展，所以SQLite是桌面轻量级数据库的首选。
事务操作是原子，一致，孤立，并且持久的(ACID)，即使在系统崩溃和电源故障之后。
零配置——不需要安装和管理。
实现了绝大多数SQL92标准。
整个数据库存储在一个单一的文件中。
数据库文件可以在不同字节序的机器之间自由地共享。
支持最大可达2T的数据库。 (241 字节)
字符串和BLOB类型的大小最大可达 2G 字节(231字节)。
小的代码： 完整配置的少于250KB，忽略一些可选特性的少于150KB。
在大多数常见操作上比流行的客户/服务器数据库引擎更快。
简单，易于使用的API。
内建TCL绑定。 另外提供可用于许多其他语言的绑定。
具有良好注释的源代码，95%经过测试。
独立：没有外部依赖。
源代码位于公共域。 可用于任何用途。
朋友介绍操作SQLite使用工具SQLiteSpy，实际上这个工具不支持数据库（如Access数据库）的导入，偶然发现还有SQLite Developer这样一个工具，管理上非常方便，操作图如下所示，使用发现功能比较丰富，支持对表字段定义的直接修改，编辑数据、Sql查询、创建、压缩、备份数据库等，对中文支持也不错。
言归正题，介绍完毕一些SQLite的使用后，继续介绍分页控件如何实现SQLite的分页处理吧。
普通版本的分页控件呈现效果如下所示。
DevExpress样式版本的分页控件效果如下所示（均支持SQLite分页）
基于SqlLite数据库的分页控件使用例子代码如下：
string
connectionString =
""
;
public
FrmCustomer()
{
InitializeComponent();
connectionString =
string
.Format(
@"
Data Source={0}\OrderWater.db;Version=3;
"
, Application.StartupPath);
}
private
void
FrmCustomer_Load(
object
sender, EventArgs e)
{
this
.winGridViewPager1.OnPageChanged +=
new
EventHandler(winGridViewPager1_OnPageChanged);
this
.winGridViewPager1.OnStartExport +=
new
EventHandler(winGridViewPager1_OnStartExport);
this
.winGridViewPager1.OnEditSelected +=
new
EventHandler(winGridViewPager1_OnEditSelected);
this
.winGridViewPager1.OnDeleteSelected +=
new
EventHandler(winGridViewPager1_OnDeleteSelected);
this
.winGridViewPager1.OnRefresh +=
new
EventHandler(winGridViewPager1_OnRefresh);
this
.winGridViewPager1.OnAddNew +=
new
EventHandler(winGridViewPager1_OnAddNew);
this
.winGridViewPager1.AppendedMenu =
this
.contextMenuStrip1;
this
.winGridViewPager1.ShowLineNumber =
true
;
//
显示行号
this
.winGridViewPager1.PagerInfo.PageSize =
20
;
//
页面大小
this
.winGridViewPager1.EventRowBackColor = Color.LightCyan;
//
间隔颜色
BindData();
}
private
void
winGridViewPager1_OnRefresh(
object
sender, EventArgs e)
{
BindData();
}
private
void
winGridViewPager1_OnDeleteSelected(
object
sender, EventArgs e)
{
if
(MessageUtil.ShowYesNoAndTips(
"
您确定删除选定的记录么？
"
) == DialogResult.No)
{
return
;
}
DataGridView grid =
this
.winGridViewPager1.dataGridView1;
if
(grid !=
null
)
{
foreach
(DataGridViewRow row
in
grid.SelectedRows)
{
//
BLLFactory<Customer>.Instance.Delete(row.Cells[0].Value.ToString());
}
BindData();
}
}
private
void
winGridViewPager1_OnEditSelected(
object
sender, EventArgs e)
{
DataGridView grid =
this
.winGridViewPager1.dataGridView1;
if
(grid !=
null
)
{
foreach
(DataGridViewRow row
in
grid.SelectedRows)
{
FrmEditCustomer dlg =
new
FrmEditCustomer();
dlg.ID = row.Cells[
0
].Value.ToString();
if
(DialogResult.OK == dlg.ShowDialog())
{
BindData();
}
break
;
}
}
}
private
void
winGridViewPager1_OnStartExport(
object
sender, EventArgs e)
{
string
where
= GetSearchSql();
PagerInfo info =
new
PagerInfo();
info.CurrenetPageIndex =
1
;
info.PageSize =
int
.MaxValue;
this
.winGridViewPager1.AllToExport = FindToDataTable(
where
, info);
}
private
void
winGridViewPager1_OnPageChanged(
object
sender, EventArgs e)
{
BindData();
}
#region
查询辅助函数
///
<summary>
///
执行SQL查询语句，返回查询结果的所有记录的第一个字段,用逗号分隔。
///
</summary>
///
<param name="sql">
SQL语句
</param>
///
<returns>
///
返回查询结果的所有记录的第一个字段,用逗号分隔。
///
</returns>
public
string
SqlValueList(
string
sql)
{
SQLiteConnection connection =
new
SQLiteConnection(connectionString);
SQLiteCommand cmd =
new
SQLiteCommand(sql, connection);
connection.Open();
StringBuilder result =
new
StringBuilder();
using
(SQLiteDataReader dr = cmd.ExecuteReader())
{
while
(dr.Read())
{
result.AppendFormat(
"
{0},
"
, dr[
0
].ToString());
}
}
string
strResult = result.ToString().Trim(
'
,
'
);
return
strResult;
}
///
<summary>
///
执行SQL查询语句，返回所有记录的DataTable集合。
///
</summary>
///
<param name="sql">
SQL查询语句
</param>
///
<returns></returns>
public
DataTable SqlTable(
string
sql)
{
DataSet ds =
new
DataSet();
SQLiteDataAdapter adpater =
new
SQLiteDataAdapter(sql, connectionString);
adpater.Fill(ds);
return
ds.Tables[
0
];
}
///
<summary>
///
标准的记录查询函数
///
</summary>
///
<param name="where"></param>
///
<param name="pagerInfo"></param>
///
<returns></returns>
private
DataTable FindToDataTable(
string
where
, PagerInfo pagerInfo)
{
WHC.Pager.WinControl.PagerHelper helper =
new
WHC.Pager.WinControl.PagerHelper(
"
All_Customer
"
,
"
*
"
,
"
LastUpdated
"
, pagerInfo.PageSize, pagerInfo.CurrenetPageIndex,
true
,
where
);
string
countSql = helper.GetPagingSql(WHC.Pager.WinControl.DatabaseType.SQLite,
true
);
string
dataSql = helper.GetPagingSql(WHC.Pager.WinControl.DatabaseType.SQLite,
false
);
string
value = SqlValueList(countSql);
pagerInfo.RecordCount = Convert.ToInt32(value);
//
为了显示具体的信息，需要设置总记录数
DataTable dt = SqlTable(dataSql);
return
dt;
}
///
<summary>
///
根据查询条件构造查询语句
///
</summary>
///
<returns></returns>
private
string
GetSearchSql()
{
SearchCondition condition =
new
SearchCondition();
condition.AddCondition(
"
Number
"
,
this
.txtNumber.Text, SqlOperator.Like)
.AddCondition(
"
Name
"
,
this
.txtName.Text, SqlOperator.Like)
.AddCondition(
"
Type
"
,
this
.cmbType.Text, SqlOperator.Like)
.AddCondition(
"
Area
"
,
this
.cmbArea.Text, SqlOperator.Like)
.AddCondition(
"
Address
"
,
this
.txtAddress.Text, SqlOperator.Like)
.AddCondition(
"
Company
"
,
this
.txtCompany.Text, SqlOperator.Like)
.AddCondition(
"
Note
"
,
this
.txtNote.Text, SqlOperator.Like)
.AddCondition(
"
Telephone1
"
,
this
.txtTelephone.Text, SqlOperator.Like,
true
,
"
Telephone
"
)
.AddCondition(
"
Telephone2
"
,
this
.txtTelephone.Text, SqlOperator.Like,
true
,
"
Telephone
"
)
.AddCondition(
"
Telephone3
"
,
this
.txtTelephone.Text, SqlOperator.Like,
true
,
"
Telephone
"
)
.AddCondition(
"
Telephone4
"
,
this
.txtTelephone.Text, SqlOperator.Like,
true
,
"
Telephone
"
)
.AddCondition(
"
Telephone5
"
,
this
.txtTelephone.Text, SqlOperator.Like,
true
,
"
Telephone
"
);
if
(chkUseDate.Checked)
{
condition.AddCondition(
"
CreateDate
"
, dateTimePicker1.Value.ToString(
"
yyyy-MM-dd
"
), SqlOperator.MoreThanOrEqual,
true
)
.AddCondition(
"
CreateDate
"
, dateTimePicker2.Value.AddDays(
1
).ToString(
"
yyyy-MM-dd
"
), SqlOperator.LessThanOrEqual,
true
);
}
string
where
= condition.BuildConditionSql().Replace(
"
Where
"
,
""
);
return
where
;
}
#endregion
private
void
BindData()
{
#region
添加别名解析
//
DisplayColumns与显示的字段名或者实体属性一致，大小写不敏感，顺序代表显示顺序，用逗号或者|分开
this
.winGridViewPager1.DisplayColumns =
"
Number,NAME,type,Area,Company,Address,Telephone1,Telephone2,Telephone3,Telephone4,Telephone5,CreateDate,Note,LastUpdated
"
;
this
.winGridViewPager1.AddColumnAlias(
"
ID
"
,
"
编号
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Number
"
,
"
客户编号
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Name
"
,
"
客户名称
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Type
"
,
"
客户类型
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Area
"
,
"
客户地区
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Company
"
,
"
客户单位
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Address
"
,
"
客户地址
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Telephone1
"
,
"
电话1
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Telephone2
"
,
"
电话2
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Telephone3
"
,
"
电话3
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Telephone4
"
,
"
电话4
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Telephone5
"
,
"
电话5
"
);
this
.winGridViewPager1.AddColumnAlias(
"
CreateDate
"
,
"
开户日期
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Shop_ID
"
,
"
分店ID
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Note
"
,
"
备注
"
);
this
.winGridViewPager1.AddColumnAlias(
"
LastUpdated
"
,
"
更新日期
"
);
#endregion
string
where
= GetSearchSql();
this
.winGridViewPager1.DataSource = FindToDataTable(
where
,
this
.winGridViewPager1.PagerInfo);
}
private
void
btnSearch_Click(
object
sender, EventArgs e)
{
BindData();
}
connectionString =
""
;
public
FrmCustomer()
{
InitializeComponent();
connectionString =
string
.Format(
@"
Data Source={0}\OrderWater.db;Version=3;
"
, Application.StartupPath);
}
private
void
FrmCustomer_Load(
object
sender, EventArgs e)
{
this
.winGridViewPager1.OnPageChanged +=
new
EventHandler(winGridViewPager1_OnPageChanged);
this
.winGridViewPager1.OnStartExport +=
new
EventHandler(winGridViewPager1_OnStartExport);
this
.winGridViewPager1.OnEditSelected +=
new
EventHandler(winGridViewPager1_OnEditSelected);
this
.winGridViewPager1.OnDeleteSelected +=
new
EventHandler(winGridViewPager1_OnDeleteSelected);
this
.winGridViewPager1.OnRefresh +=
new
EventHandler(winGridViewPager1_OnRefresh);
this
.winGridViewPager1.OnAddNew +=
new
EventHandler(winGridViewPager1_OnAddNew);
this
.winGridViewPager1.AppendedMenu =
this
.contextMenuStrip1;
this
.winGridViewPager1.ShowLineNumber =
true
;
//
显示行号
this
.winGridViewPager1.PagerInfo.PageSize =
20
;
//
页面大小
this
.winGridViewPager1.EventRowBackColor = Color.LightCyan;
//
间隔颜色
BindData();
}
private
void
winGridViewPager1_OnRefresh(
object
sender, EventArgs e)
{
BindData();
}
private
void
winGridViewPager1_OnDeleteSelected(
object
sender, EventArgs e)
{
if
(MessageUtil.ShowYesNoAndTips(
"
您确定删除选定的记录么？
"
) == DialogResult.No)
{
return
;
}
DataGridView grid =
this
.winGridViewPager1.dataGridView1;
if
(grid !=
null
)
{
foreach
(DataGridViewRow row
in
grid.SelectedRows)
{
//
BLLFactory<Customer>.Instance.Delete(row.Cells[0].Value.ToString());
}
BindData();
}
}
private
void
winGridViewPager1_OnEditSelected(
object
sender, EventArgs e)
{
DataGridView grid =
this
.winGridViewPager1.dataGridView1;
if
(grid !=
null
)
{
foreach
(DataGridViewRow row
in
grid.SelectedRows)
{
FrmEditCustomer dlg =
new
FrmEditCustomer();
dlg.ID = row.Cells[
0
].Value.ToString();
if
(DialogResult.OK == dlg.ShowDialog())
{
BindData();
}
break
;
}
}
}
private
void
winGridViewPager1_OnStartExport(
object
sender, EventArgs e)
{
string
where
= GetSearchSql();
PagerInfo info =
new
PagerInfo();
info.CurrenetPageIndex =
1
;
info.PageSize =
int
.MaxValue;
this
.winGridViewPager1.AllToExport = FindToDataTable(
where
, info);
}
private
void
winGridViewPager1_OnPageChanged(
object
sender, EventArgs e)
{
BindData();
}
#region
查询辅助函数
///
<summary>
///
执行SQL查询语句，返回查询结果的所有记录的第一个字段,用逗号分隔。
///
</summary>
///
<param name="sql">
SQL语句
</param>
///
<returns>
///
返回查询结果的所有记录的第一个字段,用逗号分隔。
///
</returns>
public
string
SqlValueList(
string
sql)
{
SQLiteConnection connection =
new
SQLiteConnection(connectionString);
SQLiteCommand cmd =
new
SQLiteCommand(sql, connection);
connection.Open();
StringBuilder result =
new
StringBuilder();
using
(SQLiteDataReader dr = cmd.ExecuteReader())
{
while
(dr.Read())
{
result.AppendFormat(
"
{0},
"
, dr[
0
].ToString());
}
}
string
strResult = result.ToString().Trim(
'
,
'
);
return
strResult;
}
///
<summary>
///
执行SQL查询语句，返回所有记录的DataTable集合。
///
</summary>
///
<param name="sql">
SQL查询语句
</param>
///
<returns></returns>
public
DataTable SqlTable(
string
sql)
{
DataSet ds =
new
DataSet();
SQLiteDataAdapter adpater =
new
SQLiteDataAdapter(sql, connectionString);
adpater.Fill(ds);
return
ds.Tables[
0
];
}
///
<summary>
///
标准的记录查询函数
///
</summary>
///
<param name="where"></param>
///
<param name="pagerInfo"></param>
///
<returns></returns>
private
DataTable FindToDataTable(
string
where
, PagerInfo pagerInfo)
{
WHC.Pager.WinControl.PagerHelper helper =
new
WHC.Pager.WinControl.PagerHelper(
"
All_Customer
"
,
"
*
"
,
"
LastUpdated
"
, pagerInfo.PageSize, pagerInfo.CurrenetPageIndex,
true
,
where
);
string
countSql = helper.GetPagingSql(WHC.Pager.WinControl.DatabaseType.SQLite,
true
);
string
dataSql = helper.GetPagingSql(WHC.Pager.WinControl.DatabaseType.SQLite,
false
);
string
value = SqlValueList(countSql);
pagerInfo.RecordCount = Convert.ToInt32(value);
//
为了显示具体的信息，需要设置总记录数
DataTable dt = SqlTable(dataSql);
return
dt;
}
///
<summary>
///
根据查询条件构造查询语句
///
</summary>
///
<returns></returns>
private
string
GetSearchSql()
{
SearchCondition condition =
new
SearchCondition();
condition.AddCondition(
"
Number
"
,
this
.txtNumber.Text, SqlOperator.Like)
.AddCondition(
"
Name
"
,
this
.txtName.Text, SqlOperator.Like)
.AddCondition(
"
Type
"
,
this
.cmbType.Text, SqlOperator.Like)
.AddCondition(
"
Area
"
,
this
.cmbArea.Text, SqlOperator.Like)
.AddCondition(
"
Address
"
,
this
.txtAddress.Text, SqlOperator.Like)
.AddCondition(
"
Company
"
,
this
.txtCompany.Text, SqlOperator.Like)
.AddCondition(
"
Note
"
,
this
.txtNote.Text, SqlOperator.Like)
.AddCondition(
"
Telephone1
"
,
this
.txtTelephone.Text, SqlOperator.Like,
true
,
"
Telephone
"
)
.AddCondition(
"
Telephone2
"
,
this
.txtTelephone.Text, SqlOperator.Like,
true
,
"
Telephone
"
)
.AddCondition(
"
Telephone3
"
,
this
.txtTelephone.Text, SqlOperator.Like,
true
,
"
Telephone
"
)
.AddCondition(
"
Telephone4
"
,
this
.txtTelephone.Text, SqlOperator.Like,
true
,
"
Telephone
"
)
.AddCondition(
"
Telephone5
"
,
this
.txtTelephone.Text, SqlOperator.Like,
true
,
"
Telephone
"
);
if
(chkUseDate.Checked)
{
condition.AddCondition(
"
CreateDate
"
, dateTimePicker1.Value.ToString(
"
yyyy-MM-dd
"
), SqlOperator.MoreThanOrEqual,
true
)
.AddCondition(
"
CreateDate
"
, dateTimePicker2.Value.AddDays(
1
).ToString(
"
yyyy-MM-dd
"
), SqlOperator.LessThanOrEqual,
true
);
}
string
where
= condition.BuildConditionSql().Replace(
"
Where
"
,
""
);
return
where
;
}
#endregion
private
void
BindData()
{
#region
添加别名解析
//
DisplayColumns与显示的字段名或者实体属性一致，大小写不敏感，顺序代表显示顺序，用逗号或者|分开
this
.winGridViewPager1.DisplayColumns =
"
Number,NAME,type,Area,Company,Address,Telephone1,Telephone2,Telephone3,Telephone4,Telephone5,CreateDate,Note,LastUpdated
"
;
this
.winGridViewPager1.AddColumnAlias(
"
ID
"
,
"
编号
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Number
"
,
"
客户编号
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Name
"
,
"
客户名称
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Type
"
,
"
客户类型
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Area
"
,
"
客户地区
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Company
"
,
"
客户单位
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Address
"
,
"
客户地址
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Telephone1
"
,
"
电话1
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Telephone2
"
,
"
电话2
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Telephone3
"
,
"
电话3
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Telephone4
"
,
"
电话4
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Telephone5
"
,
"
电话5
"
);
this
.winGridViewPager1.AddColumnAlias(
"
CreateDate
"
,
"
开户日期
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Shop_ID
"
,
"
分店ID
"
);
this
.winGridViewPager1.AddColumnAlias(
"
Note
"
,
"
备注
"
);
this
.winGridViewPager1.AddColumnAlias(
"
LastUpdated
"
,
"
更新日期
"
);
#endregion
string
where
= GetSearchSql();
this
.winGridViewPager1.DataSource = FindToDataTable(
where
,
this
.winGridViewPager1.PagerInfo);
}
private
void
btnSearch_Click(
object
sender, EventArgs e)
{
BindData();
}
以上例子关键的地方有3个
1、 数据库字符串
connectionString =
string
.Format(
@"
Data Source={0}\OrderWater.db;Version=3;
"
, Application.StartupPath);
2.、查询数据操作
数据查询通过调用 System.Data.SQLite.DLL 的程序集实现数据访问操作，如下所示。
public
DataTable SqlTable(
string
sql)
{
DataSet ds =
new
DataSet();
SQLiteDataAdapter adpater =
new
SQLiteDataAdapter(sql, connectionString);
adpater.Fill(ds);
return
ds.Tables[
0
];
}
DataTable SqlTable(
string
sql)
{
DataSet ds =
new
DataSet();
SQLiteDataAdapter adpater =
new
SQLiteDataAdapter(sql, connectionString);
adpater.Fill(ds);
return
ds.Tables[
0
];
}
3、 SQLite分页语句调用生成
调用内置的类实现分页语句的生成，代码如下所示。
WHC.Pager.WinControl.PagerHelper helper =
new
WHC.Pager.WinControl.PagerHelper(
"
All_Customer
"
,
"
*
"
,
"
LastUpdated
"
, pagerInfo.PageSize, pagerInfo.CurrenetPageIndex,
true
,
where
);
string
countSql = helper.GetPagingSql(WHC.Pager.WinControl.DatabaseType.SQLite,
true
);
new
WHC.Pager.WinControl.PagerHelper(
"
All_Customer
"
,
"
*
"
,
"
LastUpdated
"
, pagerInfo.PageSize, pagerInfo.CurrenetPageIndex,
true
,
where
);
string
countSql = helper.GetPagingSql(WHC.Pager.WinControl.DatabaseType.SQLite,
true
);
string
dataSql = helper.GetPagingSql(WHC.Pager.WinControl.DatabaseType.SQLite,
false
);
完整可运行例子如下下载即可：