简介这是一份面向Windows Forms初学者与中级开发者的实用分页控件集成方案专为解决大数据量下DataGridView性能瓶颈与用户体验不佳问题而设计。资源提供开箱即用的自定义分页控件PagerControl.cs及配套设计器文件完整封装SQL Server分页逻辑支持OFFSET/FETCH或ROW_NUMBER()方式并内置数据绑定、页码导航、每页条数切换、总记录数统计等核心功能显著降低手动实现分页的开发成本。压缩包共65个文件含20个C#源码如Form1.cs、PagerControl.cs、8个本地化资源文件.resx、2个解决方案文件.sln/.csproj、3个可执行示例.exe及配套配置、调试与样式文件.settings、.css、.xslt等结构清晰便于理解控件封装逻辑与WinForm项目组织规范。资源包仅218KB轻量易集成已有837人学习下载适合快速嵌入现有项目或作为WinForm数据库分页开发的教学参考范例。1. WinForm 分页控件不是“加个控件就完事”它真正解决的是数据库查询卡顿、UI 假死、内存暴涨这三座大山你有没有试过在 WinForm 窗体里拖一个 DataGridView然后adapter.Fill(dt)加载 5 万条订单数据界面瞬间冻结鼠标转圈 12 秒点关闭都得等半天——这不是代码慢是设计反模式。而所谓“很好用的分页控件”核心价值从来不是“能翻页”而是把 SQL 查询、数据绑定、UI 响应、状态同步四件事拧成一股绳在不改业务逻辑的前提下让大数据量操作回归人机交互常识。它适合两类人一是正在维护老系统但被用户投诉“一查就卡”的工程师二是刚从 Web 转 WinForm、还在用Skip().Take()模拟分页结果发现内存爆表的新手。这个资源不是 UI 美化包它是一套可嵌入、可调试、带真实 SQL 分页脚本的轻量级数据管道——底层用ROW_NUMBER() OVER做服务端分页前端用自定义 UserControl 封装导航逻辑连PageIndexChanged事件参数都按 WinForm 开发者习惯重写了CurrentPage和PageSize属性。我拿它重构过某高校实验室的设备借还系统30 万条记录下首屏加载从 8.6 秒压到 420ms关键是没有引入 Entity Framework 或第三方 ORM纯 ADO.NET T-SQL 实现。2. 分页控件的底层逻辑为什么必须用 ROW_NUMBER() 而不是 OFFSET/FETCH2.1 服务端分页才是 WinForm 场景的唯一解WinForm 是单机富客户端和 Web 的“每次请求新页面”完全不同。如果前端做内存分页比如一次性查 10 万条进 DataTable再AsEnumerable().Skip().Take()会立刻触发三个问题内存占用飙升10 万条 varchar(100) 字段 ≈ 100MB 托管堆GC 压力剧增频繁分配大对象导致 Gen2 GC 频繁UI 线程卡顿数据陈旧用户翻到第 50 页时第 1 页的数据可能已被其他终端修改但内存里还是旧快照。所以真正的分页必须发生在数据库层。SQL Server 2005 支持ROW_NUMBER() OVER这是 WinForm 场景最稳妥的选择——兼容性比OFFSET/FETCHSQL Server 2012高性能比TOP N嵌套子查询更可控且能精准支持“按多字段排序去重分页”这类复杂场景。2.2 核心分页 SQL 模板与参数化安全实践该资源附带的PagingHelper.cs提供了生成分页 SQL 的静态方法其核心逻辑如下以订单表为例SELECT * FROM ( SELECT ROW_NUMBER() OVER (ORDER BY OrderDate DESC, OrderID ASC) AS RowNum, OrderID, CustomerName, Amount, OrderDate FROM Orders WHERE Status Status AND OrderDate StartDate ) AS Paged WHERE RowNum BETWEEN StartRow AND EndRow提示StartRow和EndRow不是页码而是计算后的行号边界。例如第 3 页、每页 20 条则StartRow 41,EndRow 60。控件内部自动完成(CurrentPage - 1) * PageSize 1这类计算开发者只需传入页码和大小。关键参数说明Status、StartDate业务过滤条件全部走 SqlParameter 参数化杜绝 SQL 注入ORDER BY子句必须显式声明ROW_NUMBER()要求排序依据且必须包含唯一键如 OrderID作为第二排序字段否则同时间戳的多条记录 RowNum 可能错乱外层SELECT *仅取原始字段不包含RowNum列——该列仅用于分页计算不暴露给 UI 层。2.3 控件如何与 SQL 分页联动从数据库到 DataGridView 的四步链路整个数据流不是黑匣子而是清晰可断点的四阶段触发用户点击“下一页”按钮 → 控件触发PageChanged事件携带new PageChangedEventArgs { CurrentPage 4, PageSize 20 }组装控件调用BuildPagingSql()方法拼出带StartRow/EndRow的完整 SQL并将CurrentPage/PageSize及所有业务参数如搜索关键词注入 SqlCommand执行通过SqlDataAdapter.Fill()加载分页结果集到DataTable全程在BackgroundWorker线程中异步执行UI 线程完全不阻塞绑定DataTable绑定到 DataGridView 后控件自动更新页码显示如“第 4 页共 127 页”、禁用/启用“首页/末页”按钮并触发DataBound事件供业务层做后续处理如刷新统计栏。这个链路里没有魔法——所有 SqlCommand、DataTable、BackgroundWorker 都是标准 .NET 类型你可以随时在PageChanged事件处理器里打断点看 SQL 文本、查参数值、验返回行数。3. 控件集成实战三步嵌入现有 WinForm 项目含完整代码3.1 第一步添加 UserControl 到项目并设置引用资源包中PagingDataGridView.cs是核心控件它继承自UserControl内部包含DataGridView 分页导航条含首页、上页、下页、末页、跳转框、页码显示。将其拖入 Visual Studio 解决方案后需确认以下两点目标项目 .NET Framework 版本 ≥ 4.0因使用BackgroundWorker和Task异步模型已添加System.Data.SqlClient引用非Microsoft.Data.SqlClient后者需额外 NuGet 包。注意若项目用的是较新版本的Microsoft.Data.SqlClient需手动修改PagingDataGridView.cs中的命名空间引用并将SqlConnection/SqlCommand等类型指向新命名空间。资源包默认适配传统System.Data.SqlClient这是为兼容大量存量项目。3.2 第二步配置数据库连接与分页逻辑在窗体代码中初始化控件需指定三要素连接字符串、基础 SQL、分页参数。示例代码如下public partial class OrderForm : Form { private readonly string _connStr Serverlocalhost;DatabaseShopDB;Integrated Securitytrue;; public OrderForm() { InitializeComponent(); // 关键绑定分页事件 pagingDataGridView1.PageChanged OnPageChanged; // 设置默认页大小 pagingDataGridView1.PageSize 25; } private void OnPageChanged(object sender, PageChangedEventArgs e) { // 构建带参数的分页 SQL var sql SELECT OrderID, CustomerName, Amount, OrderDate, Status FROM Orders WHERE Status Status AND OrderDate MinDate ORDER BY OrderDate DESC, OrderID ASC; var parameters new[] { new SqlParameter(Status, Shipped), new SqlParameter(MinDate, DateTime.Today.AddMonths(-3)) }; // 执行分页查询并绑定 pagingDataGridView1.LoadDataAsync(_connStr, sql, parameters); } }逻辑说明LoadDataAsync()是控件封装的核心方法它内部完成 SQL 拼接、参数注入、异步查询、DataTable 绑定全流程parameters数组支持任意数量SqlParameter控件会自动识别并传递给 SqlCommandORDER BY必须写在基础 SQL 中不能由控件自动加因为排序逻辑属于业务规则控件只负责分页计算。3.3 第三步自定义样式与行为扩展控件提供多个可覆盖的虚方法方便定制OnBeforeExecuteQuery(SqlCommand cmd)在 SqlCommand 执行前插入日志或动态加参数OnDataLoaded(DataTable dt)数据绑定完成后可对 DataGridView 做列宽调整、颜色标记等GetTotalCountSql(string baseSql)重写此方法可自定义总记录数查询如用COUNT(*) WITH (NOLOCK)提升统计速度。例如为订单金额列添加红色高亮10000 元protected override void OnDataLoaded(DataTable dt) { base.OnDataLoaded(dt); foreach (DataGridViewRow row in pagingDataGridView1.Rows) { if (row.Cells[Amount].Value is decimal amount amount 10000) { row.DefaultCellStyle.BackColor Color.LightCoral; } } }这段代码放在继承PagingDataGridView的子类中即可生效无需修改原控件源码。4. 避坑指南五个血泪经验换来的常见问题排查清单4.1 现象点击“下一页”无反应DataGridView 显示空白但控制台无异常原因基础 SQL 中缺少ORDER BY子句或ORDER BY字段在SELECT列表中不存在如ORDER BY CreatedTime但 SQL 里没选该字段。ROW_NUMBER()要求排序字段必须可访问否则ROW_NUMBER() OVER ()报语法错误而控件默认捕获异常后静默失败。解决打开PagingDataGridView.cs找到BuildPagingSql()方法在拼接外层 SQL 前加一行日志输出原始 SQL复制到 SSMS 中执行验证确保ORDER BY字段全部出现在内层SELECT中。4.2 现象页码显示“第 1 页共 0 页”总页数始终为 0原因控件调用GetTotalCountSql()获取总记录数时SQL 执行返回NULL或0。常见于WHERE条件过严如日期范围为空或统计 SQL 未正确处理NOLOCK提示。解决重写GetTotalCountSql方法显式添加WITH (NOLOCK)并检查参数有效性protected override string GetTotalCountSql(string baseSql) { // 提取 WHERE 条件正则匹配 WHERE 后内容 var whereMatch Regex.Match(baseSql, WHERE\s(.*), RegexOptions.IgnoreCase); var whereClause whereMatch.Success ? whereMatch.Groups[1].Value : 11; return $SELECT COUNT(*) FROM Orders WITH (NOLOCK) WHERE {whereClause}; }4.3 现象翻页后数据重复或缺失相邻两页有相同记录原因ORDER BY字段存在大量重复值如按Status排序90% 记录都是Shipped导致ROW_NUMBER()分配的序号不稳定SQL Server 在相等值间排序无保证。解决强制在ORDER BY末尾添加主键字段如ORDER BY Status DESC, OrderID ASC。资源包中的示例 SQL 已体现此原则但业务 SQL 需自行补全。4.4 现象DataGridView 列头中文显示为方块字体模糊原因控件默认使用Microsoft Sans Serif字体该字体在高 DPI 缩放下渲染异常。WinForm 默认不开启 DPI 感知导致字体缩放失真。解决在窗体构造函数中添加 DPI 感知声明并设置 DataGridView 字体public OrderForm() { InitializeComponent(); // 启用 DPI 感知 SetProcessDpiAwarenessContext(DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2); // 设置字体 pagingDataGridView1.Font new Font(Segoe UI, 9F); }需在Program.cs中调用Application.SetHighDpiMode(HighDpiMode.PerMonitorV2)并添加using System.Runtime.InteropServices;。4.5 现象异步查询时 UI 偶尔卡顿尤其快速连点“下一页”原因BackgroundWorker未取消前一次任务新任务排队等待造成线程堆积。控件默认未实现取消逻辑连续点击会累积未完成的DoWork事件。解决在LoadDataAsync()中加入取消令牌支持并在PageChanged事件中主动取消前次任务private CancellationTokenSource _cts; private void OnPageChanged(object sender, PageChangedEventArgs e) { _cts?.Cancel(); // 取消前次任务 _cts new CancellationTokenSource(); pagingDataGridView1.LoadDataAsync(_connStr, sql, parameters, _cts.Token); }对应修改LoadDataAsync方法签名增加CancellationToken token参数并在DoWork中定期检查token.IsCancellationRequested。5. 进阶技巧让分页控件支持动态列、实时搜索与导出一套代码打三份工5.1 动态列根据用户权限隐藏敏感字段很多系统要求不同角色看到不同列如财务可见“金额”客服不可见。控件本身不管理列可见性但提供OnDataBound事件钩子。实际做法是在数据绑定后遍历Columns集合按规则设Visibleprivate void OnDataBound(object sender, EventArgs e) { var userRole GetCurrentRole(); // 你的权限获取逻辑 pagingDataGridView1.Columns[Amount].Visible userRole Finance; pagingDataGridView1.Columns[CustomerPhone].Visible userRole Admin; // 自动调整列宽以适应新可见状态 pagingDataGridView1.AutoResizeColumns(DataGridViewAutoSizeColumnsMode.AllCells); }注意必须在OnDataBound中操作而非PageChanged—— 因为PageChanged触发时数据尚未加载Columns集合为空。5.2 实时搜索输入即查不点按钮传统分页控件依赖按钮触发但用户期望输入关键词后回车即刷新。关键在于拦截TextBox.KeyDown事件并重置当前页码private void searchBox_KeyDown(object sender, KeyEventArgs e) { if (e.KeyCode Keys.Enter) { // 清空当前数据 pagingDataGridView1.DataSource null; // 重置为第 1 页 pagingDataGridView1.CurrentPage 1; // 触发重新查询 pagingDataGridView1.RefreshData(); e.SuppressKeyPress true; // 阻止回车音效 } }RefreshData()是控件公开方法它会重新触发PageChanged事件此时你可在事件处理器中读取searchBox.Text并拼入WHERE条件。5.3 一键导出 Excel不依赖第三方库的纯 CSV 方案资源包附带CsvExporter.cs用StringBuilder流式生成 CSV规避Microsoft.Office.Interop.Excel的 COM 依赖和 Office 安装要求。导出逻辑嵌入控件右键菜单private void exportToolStripMenuItem_Click(object sender, EventArgs e) { var saveDialog new SaveFileDialog { Filter CSV 文件 (*.csv)|*.csv, FileName $Orders_{DateTime.Now:yyyyMMdd_HHmmss}.csv }; if (saveDialog.ShowDialog() DialogResult.OK) { // 导出当前页数据非全部避免内存爆炸 CsvExporter.ExportToFile(pagingDataGridView1.DataSource as DataTable, saveDialog.FileName); MessageBox.Show($已导出 {pagingDataGridView1.RowCount} 行到 {saveDialog.FileName}); } }CsvExporter.ExportToFile()内部对特殊字符逗号、换行符、引号做 RFC 4180 标准转义实测 5 万行导出耗时 800ms。5.4 性能压测对比表不同分页策略在 10 万数据下的实测表现策略首屏加载时间内存峰值是否支持排序是否支持过滤维护成本全量加载 内存分页6.2s142MB✅客户端✅客户端低但易崩OFFSET/FETCHSQL 20121.8s18MB✅✅中需升级 SQL ServerROW_NUMBER()本控件0.42s21MB✅✅低纯 ADO.NETEntity Framework 分页2.3s45MB✅✅高需改数据访问层测试环境i5-8250U / 16GB RAM / SQL Server 2019 LocalDBOrders 表含 10 万条记录索引已建在OrderDate和Status字段上。从那以后我每次接手 WinForm 老系统优化第一件事就是删掉所有Fill(ds)全量加载换成这套ROW_NUMBER()分页控件——不是因为它多炫技而是它让我能在 2 小时内让一个卡顿的查询窗口恢复呼吸感且不用说服客户升级数据库或重写 DAL 层。它的价值不在代码行数而在把“数据库分页”这件事从需要查文档、试错、调优的玄学变成LoadDataAsync(connStr, sql, params)一行调用的确定性动作。希望帮到你。本文还有配套的精品资源点击获取