简介这是一份面向WinForm开发者的DataGridView分页控件源码资源适合需要在桌面应用中快速实现表格分页功能的初中级开发者。控件由作者自行封装将分页逻辑与DataGridView绑定调用方式简单可直接集成到现有项目中省去从零编写分页代码的时间。压缩包共45个文件约96KB包含10个cs源码文件、5个dll程序集、4个resx与resources资源文件、2个csproj工程文件及sln解决方案另有pdb调试符号、exe可执行程序与少量临时缓存文件源码与可运行示例并存便于对照理解控件结构。资源内附完整工程与测试用例读者可查看分页控件的设计器代码、属性配置与调用示例快速掌握翻页、页码切换等核心实现思路并在此基础上按需扩展。目前已有222人学习下载适合希望提升WinForm表格交互体验的开发者参考借鉴。1. 从一次数据卡顿说起WinForm DataGridView 分页控件的真实价值去年帮一个做工业控制上位机的朋友排查问题产线报工界面在加载三个月的生产记录时直接卡死鼠标转圈十几秒操作员以为死机了。打开代码一看DataGridView 一次性绑定了两万多行 DataTable没有分页没有虚拟模式每次刷新都全量重绘。这不是个例WinForm 项目里 DataGridView 默认全量加载数据是性能翻车的重灾区。分页控件要解决的核心问题就一个让 DataGridView 只渲染当前页需要的那几十行数据把查询压力从内存转移到数据库的 LIMIT/OFFSET 上。这个分页控件适合两类人一是维护老 WinForm 项目的工程师二是做工业控制上位机、MES 终端、数据采集客户端时需要在有限硬件资源下展示大量历史记录的开发者。它不依赖第三方 UI 库纯 C# 实现能直接嵌进现有窗体。2. 分页控件的核心机制从数据源到 UI 的完整链路2.1 为什么不能靠 DataGridView 自身做分页DataGridView 没有内置分页能力它的设计定位是数据展示网格不是数据管理容器。很多人第一反应是绑定完整 DataTable 然后隐藏行这种做法在数据量超过五千行时内存占用和渲染耗时都会指数级上升。分页的本质是在数据访问层截断结果集只把当前页的数据交给 DataGridView 绑定。常见做法是封装一个分页查询方法接收页码和每页条数两个参数返回当前页的 DataTable 和总记录数。总记录数用来计算总页数驱动分页按钮的可用状态。这个链路里数据库负责 LIMIT 和 COUNTC# 端负责组装 DataTable 和更新 UIDataGridView 只做它最擅长的事——渲染几十行数据。2.2 分页控件的类结构设计一个可复用的分页控件通常包含三个部分分页参数模型、数据访问辅助类、UI 控件本体。分页参数模型持有当前页码、每页条数、总记录数、总页数四个属性并提供计算属性如是否有上一页/下一页。数据访问辅助类负责拼接分页 SQL 并执行查询返回 DataTable。UI 控件本体继承 UserControl内部放置按钮和标签暴露一个 PageChanged 事件供宿主窗体订阅。下面是一个分页参数模型的代码示例public class PagerInfo { public int PageIndex { get; set; } 1; // 当前页码从 1 开始 public int PageSize { get; set; } 50; // 每页条数默认 50 public int TotalCount { get; set; } 0; // 总记录数由 COUNT 查询填充 public int TotalPages (TotalCount PageSize - 1) / PageSize; // 向上取整 public bool HasPrev PageIndex 1; public bool HasNext PageIndex TotalPages; }这段代码里 PageSize 默认值设为 50 是工业场景下的经验值太小会导致频繁翻页太大则失去分页意义。TotalPages 用向上取整公式计算避免最后一页数据被截断。HasPrev 和 HasNext 直接驱动按钮的 Enabled 属性不需要在 UI 层再做判断。2.3 分页 SQL 的两种写法与选型分页查询 SQL 有两种主流写法选哪种取决于数据库类型和版本。第一种是 ROW_NUMBER() 窗口函数适用于 SQL Server 2005 及以上版本兼容性好逻辑清晰。第二种是 OFFSET FETCH适用于 SQL Server 2012 及以上版本语法更简洁。如果项目用的是 MySQL直接 LIMIT offset, size 即可。下面以 SQL Server 2012 为例-- 查询当前页数据 SELECT * FROM ProductionRecords ORDER BY RecordTime DESC OFFSET (PageIndex - 1) * PageSize ROWS FETCH NEXT PageSize ROWS ONLY; -- 查询总记录数 SELECT COUNT(*) FROM ProductionRecords;参数 PageIndex 和 PageSize 由 C# 端传入注意 OFFSET 的值从 0 开始所以要用 (PageIndex - 1) * PageSize。ORDER BY 子句必须存在否则 OFFSET FETCH 会报错。COUNT 查询和分页查询最好在同一个事务或同一个连接中执行避免数据不一致导致页码越界。2.4 把分页控件挂到 DataGridView 上的完整步骤第一步在 Visual Studio 中新建一个 UserControl命名为 PagerControl。第二步在控件上放置四个 Button首页、上一页、下一页、末页和两个 Label当前页码、总页数再加一个 NumericUpDown 用于跳转指定页。第三步在控件代码中定义 PageChanged 事件和 PagerInfo 属性。第四步在宿主窗体中实例化 PagerControl订阅 PageChanged 事件在事件处理中调用数据访问方法并重新绑定 DataGridView。第五步窗体加载时先执行 COUNT 查询初始化 TotalCount再触发第一次分页查询。下面是一个宿主窗体中的调用示例private void OnPageChanged(object sender, EventArgs e) { var pager sender as PagerControl; if (pager null) return; // 从分页控件获取当前分页参数 var info pager.PagerInfo; // 调用数据访问层获取当前页数据 string sql SELECT * FROM ProductionRecords ORDER BY RecordTime DESC OFFSET Offset ROWS FETCH NEXT Size ROWS ONLY; var dt DbHelper.ExecuteQuery(sql, new { Offset (info.PageIndex - 1) * info.PageSize, Size info.PageSize }); // 重新绑定 DataGridView dataGridView1.DataSource dt; // 更新分页控件上的页码显示和按钮状态 pager.UpdateUI(); }这段代码的关键点在于 Offset 的计算和 DataGridView 的重新绑定。每次翻页都重新查询数据库而不是在内存中缓存全量数据。UpdateUI 方法负责刷新页码标签和按钮的 Enabled 状态避免用户点到越界页码。3. 避坑指南分页控件落地时的五个血泪教训3.1 翻页后 DataGridView 滚动条位置错乱现象从第一页翻到第二页后DataGridView 的滚动条还停留在上一页的位置用户以为数据没变。原因重新绑定 DataSource 后DataGridView 不会自动重置滚动条。解决在绑定数据后调用 dataGridView1.FirstDisplayedScrollingRowIndex 0如果行数为零则跳过。这个坑在工业现场特别明显操作员会反复点击翻页按钮。3.2 COUNT 查询和分页查询数据不一致导致页码越界现象用户在第 5 页时后台新增了数据TotalCount 变大但当前页数据为空。原因COUNT 查询和分页查询不在同一事务中中间有数据写入。解决在分页查询前重新执行一次 COUNT或者在数据访问层加一个轻量级缓存缓存有效期设为 2 秒。更稳妥的做法是捕获空结果集时自动回退到上一页。3.3 每页条数设置过大导致内存溢出现象把 PageSize 设为 5000 后程序在低配工控机上频繁崩溃。原因DataGridView 虽然只绑定 5000 行但每行有多个列加上 DataTable 本身的开销内存占用远超预期。解决PageSize 控制在 100 以内工业场景建议 30 到 50。如果确实需要展示更多数据改用虚拟模式VirtualMode。3.4 分页控件按钮状态未及时刷新现象在第一页时“上一页”按钮仍然可点击点击后页码变成 0查询报错。原因按钮的 Enabled 属性只在初始化时设置了一次翻页后没有更新。解决在 PageChanged 事件处理中调用 UpdateUI 方法根据 HasPrev 和 HasNext 动态设置按钮状态。这个逻辑要放在数据绑定之后确保 TotalPages 已经更新。3.5 异步查询时 UI 线程阻塞现象点击翻页按钮后界面卡住两秒按钮呈灰色不可用状态。原因分页查询在 UI 线程同步执行数据库响应慢时直接阻塞消息循环。解决用 async/await 包装数据访问方法在查询期间禁用翻页按钮并显示“加载中”提示。注意 DataGridView 的数据绑定必须在 UI 线程上执行可以用 Invoke 或 await 后的上下文切换。4. 进阶技巧让分页控件适配复杂业务场景4.1 支持自定义每页条数和跳转指定页基础分页控件只提供上一页/下一页但实际项目中用户经常需要跳转到指定页或调整每页条数。在 PagerControl 上加一个 ComboBox选项为 20、50、100、200选中后重置 PageIndex 为 1 并触发查询。再加一个 TextBox 和“跳转”按钮输入页码后校验范围再触发查询。下面是一个跳转逻辑的代码片段private void btnGo_Click(object sender, EventArgs e) { int target; if (!int.TryParse(txtPage.Text, out target)) return; if (target 1 || target PagerInfo.TotalPages) return; PagerInfo.PageIndex target; OnPageChanged(this, EventArgs.Empty); // 触发宿主窗体的查询 }这段代码里 int.TryParse 避免了非数字输入导致的异常范围校验防止越界。触发查询时直接调用 OnPageChanged复用已有的查询链路不需要重复写数据访问代码。4.2 分页与搜索条件的联动实际业务中分页往往和搜索框一起使用。用户输入关键字后点击搜索PageIndex 必须重置为 1否则可能停留在第 10 页但搜索结果只有 2 页。常见做法是在搜索按钮的事件处理中先把 PagerInfo.PageIndex 设为 1再执行带 WHERE 条件的 COUNT 和分页查询。WHERE 条件要同时作用于 COUNT 和分页查询否则 TotalCount 会偏大。下面是一个带搜索条件的分页查询示例string where WHERE 11; var parameters new Dictionarystring, object(); if (!string.IsNullOrEmpty(txtKeyword.Text)) { where AND ProductName LIKE Keyword; parameters[Keyword] % txtKeyword.Text %; } // COUNT 查询 string countSql SELECT COUNT(*) FROM ProductionRecords where; int total Convert.ToInt32(DbHelper.ExecuteScalar(countSql, parameters)); // 分页查询 string pageSql $SELECT * FROM ProductionRecords {where} ORDER BY RecordTime DESC OFFSET Offset ROWS FETCH NEXT Size ROWS ONLY; parameters[Offset] (PagerInfo.PageIndex - 1) * PagerInfo.PageSize; parameters[Size] PagerInfo.PageSize; var dt DbHelper.ExecuteQuery(pageSql, parameters);这段代码用 WHERE 11 作为拼接起点避免判断第一个条件时写额外的 if。参数化查询防止 SQL 注入LIKE 的百分号在参数值里拼接而不是在 SQL 字符串里。COUNT 和分页查询共用同一个 where 变量和参数字典保证条件一致。4.3 分页控件的验证方法与性能观察写完分页控件后用三个指标验证是否合格。第一翻页响应时间在 10 万条记录的表上每次翻页应在 200 毫秒内完成。第二内存占用翻页 20 次后进程内存不应持续增长用任务管理器观察。第三边界测试在第一页点上一页、在最后一页点下一页、在只有一页时点首页和末页按钮状态都应正确。我一般会在数据访问层加一个 Stopwatch 计时把每次查询耗时输出到 Debug 窗口方便定位慢查询。从那以后我每次做分页功能都会先在 10 万条测试数据上跑一遍边界用例确认没有越界和内存泄漏才交付。希望帮到你。本文还有配套的精品资源点击获取