使用 C# 进行数据库开发时，分页功能是必不可少的。每次手动编写分页逻辑不仅耗时，而且容易出错。因此，我决定开发一个用户控件，以简化分页操作。
控件效果如下图所示：
如果您需要这个控件，可以联系我免费获取。该控件是开源的，只有一个源文件，这意味着您可以直接将它集成到您的项目中，无需额外的 ocx 文件。
由于这是我个人使用的控件，目前功能较为简单，但您可以根据需要进行扩展，并将修改后的版本分享给我。
接下来，我将详细介绍控件的主要属性、方法和事件。
SQLText 属性：
用于编写分页 SQL 语句，支持以下几个变量：{pagecount} 表示总页数，{recordcount} 表示记录总数，{pagesize} 表示每页记录数，{pageindex} 表示当前页数，{recordnum} 表示当前页之前的记录数。
例如，可以编写如下分页语句：
ctlMyPage1.SQLText = "select top {pagesize} * from 表1 where id not in (select top {recordnum} id from 表1 order by id) order by id";
(其中 id 是表的自增主键)
SQLText2 属性：
该属性是可选的，当 {recordnum} 值小于等于 0 时，控件会调用该属性。如果该属性为空，则使用 SQLText 属性。主要用于解决 Access 数据库不支持 Top 0 的问题。
例如，可以编写如下分页语句：
ctlMyPage1.SQLText2 = "select top {pagesize} * from 表1 order by id";
(其中 id 是表的自增主键)
GetSQLText 属性：
该属性为只读属性，用于获取实际执行的 SQL 语句，会将变量替换为具体的值，并根据情况自动选择 SQLText 或 SQLText2 属性。
RecordCount 属性：
用于设置记录总数，通常需要在首次调用控件时查询数据库。
PageSize 属性：
用于设置或返回每页显示的记录数，默认值为 50 条。
GetCurrPageIndex 方法：
用于获取当前页码。
GotoPageIndex 方法：
用于跳转到指定页码，例如：ctlMyPage1.GotoPageIndex(1); 表示跳转到第一页。
OnPageChange 事件：
当页面发生变化时触发此事件，可以在该事件中编写数据库查询语句。
下面是一个完整的示例代码（假设用户控件名为 ctlMyPage1）：
查询按钮 Click 事件代码：
OleDbCommand cm = new OleDbCommand();
cm.CommandText = "select count(*) from 表1";
cm.COnnection= co;
OleDbDataReader dr = cm.ExecuteReader();
while (dr.Read()) {
// 设置记录总数
ctlMyPage1.RecordCount = Convert.ToInt16(dr[0].ToString());
break;
}
dr.Close();
ctlMyPage1.SQLText = "select top {pagesize} * from 表1 where id not in (select top {recordnum} id from 表1 order by id) order by id";
ctlMyPage1.SQLText2 = "select top {pagesize} * from 表1 order by id";
ctlMyPage1.GotoPageIndex(1); // 跳转到第一页
OnPageChange 事件：
private void ctlMyPage1_OnPageChange(object sender, EventArgs e) {
// 清空列表内容
OleDbCommand cm = new OleDbCommand();
cm.CommandText = ctlMyPage1.GetSQLText;
cm.COnnection= co;
OleDbDataReader dr = cm.ExecuteReader();
while (dr.Read()) {
// 将查询结果添加到列表中
}
}
通过以上步骤，您可以轻松实现带有分页功能的数据库查询应用。如果您对这个控件感兴趣，欢迎留言获取。
京公网安备 11010802041100号