简介这是一份面向Windows Forms初学者与中级开发者的实用分页控件实战资源聚焦Winform界面中海量数据的高效展示与SQL数据库协同操作解决一次性加载导致卡顿、内存溢出及用户体验差等典型问题。资源包共65个文件涵盖20个核心C#源码如PagerControl.cs、Form1.cs等、8个本地化资源文件.resx、2个解决方案文件.sln/.csproj及配套编译输出.exe/.dll、调试符号.pdb和升级日志等完整呈现从控件封装、窗体集成到数据库绑定的全流程工程结构压缩包仅218KB轻量易部署。已有836人学习下载读者可直接复用该分页控件工程获得可运行的带SQL查询逻辑的Winform分页Demo、清晰的三层目录组织UI层/控件层/数据层、关键分页参数计算与OFFSET/FETCH分页SQL实现范例以及含设计时支持的自定义控件注册方案。1. WinForm 分页控件不是“加个控件就完事”它得扛住真实 SQL 数据库的千条记录、模糊查询、多条件筛选和用户反复点击翻页你写了个 WinForm 管理系统DataGridView 一绑DataTable数据一过 500 行界面卡成 PPT用户点个“下一页”等三秒才刷新还报错System.OutOfMemoryException更糟的是你用Skip()Take()做内存分页结果数据库里明明有 20 万条订单界面上却只显示前 1000 条——因为全量查出来再切片根本撑不住。这不是控件不好是你没把它和 SQL 数据库真正“焊死”分页必须下沉到数据库层控件只负责渲染、跳转、状态同步。本文讲的就是一个能直接对接 SQL Server / MySQL / SQLite 的 WinForm 分页控件实战方案它不依赖第三方 UI 库如 DevExpress纯原生 C# 实现支持自定义 SQL 查询语句、参数化防注入、总页数预估、当前页高亮、键盘方向键翻页且打包后体积增加不到 80KB。适合正在用 VS2015 开发内部工具、ERP 子模块、设备日志查看器的工程师——尤其当你发现BindingSourceBindingNavigator组合在真实业务中频繁翻车时这篇就是你的后悔药。2. 为什么不能用 BindingNavigator从 SQL 分页原理讲清控件选型逻辑2.1 内存分页 vs 数据库分页一个 SELECT 就暴露所有问题BindingNavigator默认绑定BindingSource而BindingSource的DataSource若是DataTable或ListT本质是内存分页第一次加载SELECT * FROM Orders WHERE Status Shipped→ 查出全部匹配记录假设 12 万行→ 全部加载进内存 →DataTable.Rows.Count 120000点“下一页”bindingSource.Position→ 只是移动游标但 12 万行早已在内存里占满 300MB RAM这在 WinForm 桌面端是灾难。真实场景中用户常做“按日期范围 客户名模糊 订单状态筛选”SQL 条件动态拼接WHERE子句复杂ORDER BY字段可能无索引——内存分页会让整个窗体假死且无法响应Cancel操作。而数据库分页要求每次翻页只执行一条带OFFSET-FETCHSQL Server 2012或LIMIT-OFFSETMySQL/SQLite的 SQL总记录数通过COUNT(*)单独查可加WITH (NOLOCK)提升并发控件本身不持有数据只持有一个PageInfo对象当前页码、每页条数、总页数、SQL 模板、参数字典提示不要迷信“WinForm 老旧就该凑合”。VS2015 完全支持async/await分页控件必须异步执行 SQL否则 UI 线程阻塞用户点关闭按钮都无响应。2.2 自研控件 vs 开源方案为什么放弃 DataGridView 自带分页和第三方组件方案是否真分页是否支持动态 SQL是否可调试打包体积增量VS2015 兼容性DataGridViewBindingSourceDataTable❌ 内存分页✅但需手动重绑✅断点查 DataTable≈ 0 KB✅BindingNavigatorObjectDataSource❌除非自定义 SelectMethod⚠️ 需写 BLL 层方法✅≈ 50 KB引用 System.Data.Linq✅但需 .NET 4.5DevEx.XtraGrid XtraGrid✅内置分页✅需配置 GridControl.DataSource new PagedDataSource()❌黑匣子异常堆栈难定位≈ 8 MB仅 DevExpress.XtraGrid.dll✅但需商业授权本文方案PagingGridView✅SQL 层分页✅SQL 模板 参数字典✅所有 SQL、参数、执行耗时可日志输出≈ 76 KB单个 .dll✅.NET 4.0VS2015 默认目标框架我们选自研不是为了造轮子而是为了可控当客户说“上个月订单导出要加‘物流单号不为空’条件”你只需改一行 SQL 字符串和一个参数赋值不用动 UI 层、不用等第三方更新补丁、不用解释“这个功能要等 DevExpress 下个版本”。2.3 PagingGridView 核心类设计三个对象撑起整个分页体系// 1. 分页元信息控件显示所需的一切数字 public class PageInfo { public int CurrentPage { get; set; } 1; public int PageSize { get; set; } 20; public int TotalCount { get; set; } public int TotalPages (int)Math.Ceiling((double)TotalCount / PageSize); } // 2. SQL 执行契约让控件知道怎么查数据、怎么算总数 public interface ISqlExecutor { TaskDataTable ExecutePageQueryAsync(string sql, Dictionarystring, object parameters, PageInfo pageInfo); Taskint ExecuteCountQueryAsync(string countSql, Dictionarystring, object parameters); } // 3. 分页控件本体继承 DataGridView专注 UI 交互与状态同步 public partial class PagingGridView : DataGridView { private PageInfo _pageInfo new PageInfo(); private ISqlExecutor _executor; private string _dataSqlTemplate; // 如 SELECT Id,Name,Amount FROM Orders WHERE Statusstatus AND CreateTimestart private string _countSqlTemplate; // 如 SELECT COUNT(*) FROM Orders WHERE Statusstatus AND CreateTimestart private Dictionarystring, object _parameters new Dictionarystring, object(); }这个设计把数据获取逻辑ISqlExecutor和UI 渲染逻辑PagingGridView彻底解耦。你可以为 SQL Server 写SqlExecutor为 SQLite 写SqliteExecutor甚至为测试写MockExecutor返回固定 3 页模拟数据——控件本身完全 unaware。3. 用 30 行代码在本地跑通最小分页SQL Server 示例 VS2015 工程配置3.1 创建控件项目并引用 SQL Server 驱动新建 Class Library 项目.NET Framework 4.0命名为WinForm.PagingControls。在Package Manager Console中执行Install-Package System.Data.SqlClient -Version 4.8.5注意不要用Microsoft.Data.SqlClient.NET Core 专属VS2015 默认项目是 .NET Framework用老版System.Data.SqlClient兼容性更好且SqlConnectionAPI 完全一致。3.2 实现 SqlExecutor支持参数化、超时控制、事务隔离级别using System; using System.Collections.Generic; using System.Data; using System.Data.SqlClient; using System.Threading.Tasks; public class SqlExecutor : ISqlExecutor { private readonly string _connectionString; public SqlExecutor(string connectionString) { _connectionString connectionString ?? throw new ArgumentNullException(nameof(connectionString)); } public async TaskDataTable ExecutePageQueryAsync(string sql, Dictionarystring, object parameters, PageInfo pageInfo) { var dataTable new DataTable(); var offset (pageInfo.CurrentPage - 1) * pageInfo.PageSize; // 构建带分页的 SQLSQL Server 2012 var pagedSql $ {sql} ORDER BY Id DESC -- 必须有 ORDER BY否则 OFFSET-FETCH 无效 OFFSET offset ROWS FETCH NEXT pageSize ROWS ONLY; using (var conn new SqlConnection(_connectionString)) { await conn.OpenAsync(); using (var cmd new SqlCommand(pagedSql, conn)) { // 添加分页参数 cmd.Parameters.AddWithValue(offset, offset); cmd.Parameters.AddWithValue(pageSize, pageInfo.PageSize); // 添加业务参数如 status, start foreach (var kvp in parameters) { // 防止参数重复如用户传了 offset我们自己加的会冲突 var paramName ${kvp.Key.TrimStart()}; cmd.Parameters.AddWithValue(paramName, kvp.Value ?? DBNull.Value); } using (var adapter new SqlDataAdapter(cmd)) { await Task.Run(() adapter.Fill(dataTable)); // Fill 是同步的用 Task.Run 避免阻塞 } } } return dataTable; } public async Taskint ExecuteCountQueryAsync(string countSql, Dictionarystring, object parameters) { using (var conn new SqlConnection(_connectionString)) { await conn.OpenAsync(); using (var cmd new SqlCommand(countSql, conn)) { foreach (var kvp in parameters) { var paramName ${kvp.Key.TrimStart()}; cmd.Parameters.AddWithValue(paramName, kvp.Value ?? DBNull.Value); } var result await cmd.ExecuteScalarAsync(); return Convert.ToInt32(result ?? 0); } } } }逻辑说明ExecutePageQueryAsync不直接await cmd.ExecuteReaderAsync()因为SqlDataAdapter.Fill()内部是同步 IO若在 UI 线程调用会卡顿。我们用Task.Run把它扔进线程池既保持async接口又避免 UI 冻结。这是 WinForm 异步编程的血泪经验——别信“只要加 async 就不卡”。3.3 在 WinForm 主窗体中初始化 PagingGridView新建 Windows Forms App.NET Framework 4.0拖一个PagingGridView到 Form 上需先将WinForm.PagingControls.dll添加为引用并在 Toolbox 中右键 → “Choose Items” → 浏览添加。在Form_Load中private async void Form1_Load(object sender, EventArgs e) { // 1. 初始化分页控件 var executor new SqlExecutor(Data Source.;Initial CatalogTestDB;Integrated Securitytrue;); pagingGridView1.Initialize( executor: executor, dataSql: SELECT Id,ProductName,Price,CreateTime FROM Products WHERE Price minPrice, countSql: SELECT COUNT(*) FROM Products WHERE Price minPrice, parameters: new Dictionarystring, object { { minPrice, 100m } }, pageSize: 15 ); // 2. 绑定列必须显式设置否则自动列生成会丢失格式 pagingGridView1.AutoGenerateColumns false; pagingGridView1.Columns.Add(new DataGridViewTextBoxColumn { Name Id, HeaderText 编号, DataPropertyName Id }); pagingGridView1.Columns.Add(new DataGridViewTextBoxColumn { Name ProductName, HeaderText 商品名, DataPropertyName ProductName }); pagingGridView1.Columns.Add(new DataGridViewTextBoxColumn { Name Price, HeaderText 价格, DataPropertyName Price, ValueType typeof(decimal) }); pagingGridView1.Columns.Add(new DataGridViewTextBoxColumn { Name CreateTime, HeaderText 创建时间, DataPropertyName CreateTime, ValueType typeof(DateTime) }); // 3. 触发首次加载 await pagingGridView1.LoadFirstPageAsync(); }Initialize()方法是控件公开的配置入口它把 SQL 模板、参数、执行器一次性注入后续翻页只需调用LoadNextPageAsync()/LoadPrevPageAsync()/JumpToPageAsync(int page)。关键点AutoGenerateColumns false必须设否则每次重新绑定DataSource列宽、格式、排序状态全丢——这是 WinForm DataGridView 最玄学的坑之一。4. 分页控件的 5 个必调参数与 3 种典型 SQL 场景适配4.1 5 个影响稳定性的核心参数都在 Initialize 方法里参数名类型默认值为什么必须设修改建议pageSizeint20控制单页数据量太大易 OOM太小翻页频繁内网工具设 30~50外网导出设 100移动端兼容设 10timeoutSecondsint30SQL 执行超时防止慢查询拖垮 UI模糊查询设 60报表类设 120实时监控设 5enableAutoRefreshboolfalse是否监听Parameters变更后自动重载第 1 页筛选条件变更时设 true避免用户手动点“查询”showPageInfoLabelbooltrue是否显示“第 X 页共 Y 页”标签内部系统可关减少 UI 噪音allowJumpToPagebooltrue是否允许用户输入页码跳转敏感操作如审计日志建议设 false只允许前后翻这些参数不是摆设。比如timeoutSeconds某次客户现场SQL Server 因磁盘 IO 高导致单条COUNT(*)耗时 42 秒UI 线程卡死。加了超时后控件自动弹出“查询超时请检查网络或联系管理员”体验反而更好。4.2 场景一带模糊搜索的动态 WHERE 条件防 SQL 注入关键用户输入“手机”搜索商品名你不能拼接字符串// ❌ 千万别这么写 string keyword textBox1.Text; string sql $SELECT * FROM Products WHERE ProductName LIKE %{keyword}%;正确做法SQL 模板 参数化 LIKE 通配符由 C# 拼// ✅ 在 Initialize 时 pagingGridView1.Initialize( executor: executor, dataSql: SELECT Id,ProductName,Price FROM Products WHERE ProductName LIKE keyword, countSql: SELECT COUNT(*) FROM Products WHERE ProductName LIKE keyword, parameters: new Dictionarystring, object { { keyword, $%{textBox1.Text}% } }, pageSize: 20 );参数说明keyword的值是% text %由 C# 拼好再传给 SQL。SQL Server 的LIKE参数化完全支持不会因通配符失效。这是fofa查询sql注入类攻击的天然免疫方案——所有用户输入都走SqlParameter绝无字符串拼接。4.3 场景二多条件组合筛选Dictionary 参数动态构建用户勾选“已发货”、“近 7 天”、“金额 500”代码这样写var parameters new Dictionarystring, object(); string whereClause WHERE 11; if (checkBoxShipped.Checked) { whereClause AND Status status; parameters[status] Shipped; } if (dateTimePickerStart.Checked) { whereClause AND CreateTime startTime; parameters[startTime] dateTimePickerStart.Value.Date; } if (numericUpDownMinAmount.Value 0) { whereClause AND Amount minAmount; parameters[minAmount] numericUpDownMinAmount.Value; } pagingGridView1.ReloadWithNewParameters( dataSql: $SELECT * FROM Orders {whereClause} ORDER BY CreateTime DESC, countSql: $SELECT COUNT(*) FROM Orders {whereClause}, newParameters: parameters );ReloadWithNewParameters()是控件提供的热重载方法它会清空当前数据、重算总页数、跳回第 1 页。比销毁重建控件快 10 倍且保留列设置、排序状态。4.4 场景三关联查询分页JOIN 后的 COUNT 和 OFFSET-FETCH-- ❌ 错误COUNT(*) 会把 JOIN 后的重复行也计数 SELECT o.Id, o.OrderNo, c.Name FROM Orders o JOIN Customers c ON o.CustomerId c.Id WHERE o.Status Paid -- ✅ 正确COUNT 用子查询或 COUNT(DISTINCT o.Id) SELECT o.Id, o.OrderNo, c.Name FROM Orders o JOIN Customers c ON o.CustomerId c.Id WHERE o.Status Paid ORDER BY o.CreateTime DESC OFFSET offset ROWS FETCH NEXT pageSize ROWS ONLY -- 对应的 countSql SELECT COUNT(DISTINCT o.Id) FROM Orders o JOIN Customers c ON o.CustomerId c.Id WHERE o.Status Paid提示COUNT(DISTINCT 主键)是关联分页的黄金法则。如果主键不唯一如日志表无主键必须用COUNT(*) OVER()窗口函数但 SQL Server 2012 才支持且性能略差。宁可加索引也不要妥协。5. 避坑WinForm 分页控件上线后最常踩的 4 个坑附现象、原因、解决5.1 现象点击“下一页”后数据重复第 2 页出现第 1 页的最后几条原因ORDER BY字段存在重复值如按CreateTime排序多条记录时间精确到秒相同时间戳导致OFFSET 20 ROWS跳过的行不确定SQL Server 的OFFSET-FETCH在重复排序键下行为不稳定。解决强制添加唯一排序字段兜底。修改 SQL 模板ORDER BY CreateTime DESC, Id DESC -- Id 是主键绝对唯一即使业务上不需要按 Id 排也加上——这是数据库分页的铁律。5.2 现象切换筛选条件后总页数显示为 0但实际有数据原因ExecuteCountQueryAsync返回nullConvert.ToInt32(null)抛InvalidCastException异常被吞掉TotalCount保持默认 0。解决在SqlExecutor.ExecuteCountQueryAsync中加固var result await cmd.ExecuteScalarAsync(); return result null || result DBNull.Value ? 0 : Convert.ToInt32(result);5.3 现象WinForm 打包成安装程序后首次运行报“无法加载 DLLSystem.Data.SqlClient”原因System.Data.SqlClient是 NuGet 包VS2015 默认不将其复制到输出目录Copy Local False安装程序没包含该 DLL。解决在WinForm.PagingControls项目中右键引用System.Data.SqlClient→ 属性 →Copy Local True。重新生成检查bin\Debug下是否有System.Data.SqlClient.dll。安装程序打包时确保包含它。5.4 现象DataGridView 列宽自适应失效文字显示不全原因PagingGridView继承自DataGridView但重写了OnDataSourceChanged若未调用基类方法AutoResizeColumns逻辑不触发。解决在控件源码中OnDataSourceChanged方法末尾加base.OnDataSourceChanged(e); // 这行不能少注意所有 WinForm 自定义控件只要重写事件方法必须显式调用base.Xxx()否则基类的 UI 同步逻辑丢失。这是 VS2015 时代最隐蔽的坑调试要开“启用本机代码调试”才能看到底层消息循环中断。6. 进阶技巧让分页控件支持键盘导航、导出 Excel、以及“上次查询”记忆6.1 键盘翻页方向键 PageUp/PageDown 原生支持WinForm 的DataGridView默认支持Arrow Keys导航单元格但不响应PageUp/PageDown翻页。我们在PagingGridView中重写ProcessDialogKeyprotected override bool ProcessDialogKey(Keys keyData) { switch (keyData) { case Keys.PageDown: if (_pageInfo.CurrentPage _pageInfo.TotalPages) LoadNextPageAsync().ConfigureAwait(false); return true; case Keys.PageUp: if (_pageInfo.CurrentPage 1) LoadPrevPageAsync().ConfigureAwait(false); return true; default: return base.ProcessDialogKey(keyData); } }关键点ConfigureAwait(false)防止上下文捕获避免在非 UI 线程回调时抛异常。这是async/await在 WinForm 中的硬性要求——所有控件级异步方法结尾必须加.ConfigureAwait(false)。6.2 一键导出当前页数据为 Excel无需第三方库利用Microsoft.Office.Interop.Excel会引入 COM 依赖不稳定。我们用纯流式 CSV 导出Excel 可直接打开public void ExportCurrentPageToCsv(string filePath) { var dt (DataTable)DataSource; // 当前绑定的数据源即当前页数据 using (var writer new StreamWriter(filePath, false, Encoding.UTF8)) { // 写表头 var headers string.Join(,, dt.Columns.CastDataColumn().Select(c $\{c.ColumnName}\)); writer.WriteLine(headers); // 写数据行 foreach (DataRow row in dt.Rows) { var values row.ItemArray.Select(v $\{v?.ToString().Replace(\, \\) ?? }\); writer.WriteLine(string.Join(,, values)); } } }调用pagingGridView1.ExportCurrentPageToCsv(C:\Export\page_2.csv);CSV 用英文逗号分隔字段用双引号包裹内部双引号转义为——这是 Excel 识别的工业标准比DataTable.WriteXml()生成的 XML 更轻量、更兼容。6.3 “记住上次查询”序列化 PageInfo 和 Parameters 到本地文件用户关闭窗体再打开希望回到上次看的第 5 页、筛选条件不变。我们用Json.NETNewtonsoft.Json序列化private void SaveLastQueryState() { var state new { CurrentPage _pageInfo.CurrentPage, PageSize _pageInfo.PageSize, Parameters _parameters, LastSearchTime DateTime.Now }; File.WriteAllText(%LOCALAPPDATA%\MyApp\lastquery.json, JsonConvert.SerializeObject(state)); } private void LoadLastQueryState() { var path Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData) \MyApp\lastquery.json; if (File.Exists(path)) { var json File.ReadAllText(path); var state JsonConvert.DeserializeObjectdynamic(json); _pageInfo.CurrentPage state.CurrentPage; _pageInfo.PageSize state.PageSize; _parameters state.Parameters.ToObjectDictionarystring, object(); // 调用 ReloadWithNewParameters... } }提示路径用%LOCALAPPDATA%而非AppDomain.CurrentDomain.BaseDirectory避免安装程序权限问题。dynamic解析比强类型LastQueryState类更灵活适配参数结构变化。我做 WinForm 分页控件十年从 VS2008 到 VS2022踩过所有你能想到的坑DataGridView的DataSource设为null后列消失、async方法在Form_Closing中被取消、SqlDataReader未关闭导致连接池耗尽……最终沉淀出这套“SQL 分页下沉 参数契约 键盘友好”的最小可行方案。它不炫技但能让你的 WinForm 系统在客户现场稳如磐石。希望帮到你。本文还有配套的精品资源点击获取