WinForm DataGridView分页控件：原理实现与避坑指南

简介：这是面向WinForm开发者的一枚DataGridView分页控件，针对数据量较大时表格加载缓慢、滚动浏览不便的痛点，封装了翻页逻辑与界面交互，使用方式简洁，可直接拖拽接入现有项目。资源共45个文件，压缩包仅96KB，10个cs源文件构成完整控件实现与测试工程，dll与exe为编译产物，resx/resources存储界面布局文案，csproj/sln与settings等工程配置齐全，便于直接引用或按需二次开发。目前已有223人学习下载，作者随包附带了测试工程与源码，既可通过运行示例直观查看分页效果，也能深入研读DGVPaging核心实现，适合初学WinForm分页机制的开发者借鉴，同时对需要快速集成表格分页功能的项目也有直接复用价值。

1. 分页控件：WinForm 里 DataGridView 最该补的一课

做 WinForm 开发的人迟早会遇到同一个尴尬：DataGridView 绑了几万行数据，界面直接卡成幻灯片，滚动一下要等两三秒，用户一边等一边催你优化。换成分页控件后，单页只显示 20 行，翻页秒开，内存占用肉眼可见地降下来。这份资源的核心就是一枚开箱即用的 DataGridView 分页控件——把「数据分页」这件事拆成了独立的用户控件，支持前进/后退/首页/末页/跳页，并提供统一的属性与事件接口。适合正在做 C/S 架构项目、被大数据量表格卡到没脾气的 C# 开发者，也适合刚接触 WinForm、想把分页逻辑和业务代码解耦的新手。它不能帮你写业务，但能让你从此告别表格卡顿。

2. 先搞懂分页原理：为什么 Web 端简单、WinForm 端老翻车

2.1 客户端假分页与服务端真分页的差别

很多从 Web 开发转 WinForm 的人一开始会困惑：Web 端分页不是很简单吗？翻页请求一次接口就行了。但 WinForm 的 DataGridView 完全没有内置分页概念，它只有一个 DataSource 属性，绑什么就显示什么。所谓的「分页控件」，本质上是帮你额外维护了一套「当前页、每页行数、总页数、数据切片」的状态机。

这里要分清两种分页策略。第一种是假分页：一次性把全量数据加载到内存里，翻页时只把当前页的数据切片赋给 DataGridView.DataSource。好处是翻页快、不依赖数据库，适合数据量在一万行以内的场景。第二种是真分页（服务端分页）：每次翻页都重新发起查询，用 SQL 的 OFFSET/FETCH 或者存储过程只取当前页数据。好处是内存占用恒定，适合大数据量，但需要后端配合。我一般建议：中小项目先上假分页，真出问题再切服务端分页。这个控件两种都支持，因为它把「取当前页数据」的逻辑单独抽了出来，你可以在事件里决定用哪种方式。

2.2 分页控件的结构设计与目录组织

这个分页控件拆开看，实际上是一个 UserControl 外加一个分页数据源类。UserControl 负责画界面——一排按钮加一个页码输入框，数据源类负责算页码、切数据、暴露事件。这样的好处是界面逻辑和数据逻辑分离，你可以不碰界面直接调用数据源类做测试，也可以换一套按钮样式不改分页逻辑。

控件里的核心类通常会包含这样几个文件：PagerControl.cs（用户控件本体）、PagedDataSource.cs（分页数据源管理类）、PagerEventArgs.cs（翻页事件参数）。PagedDataSource 里维护的变量和对应的控件属性在源码里都有，后续章节会逐一拆解每个参数的具体含义和踩坑点。

2.3 核心参数与数据流设计

分页控件的关键参数如下，这几个属性你拿到手先过一遍，后面用的时候就不会迷糊。

数据流向是：外部传入全量 DataTable 或数据集合 → PagedDataSource 记录 TotalRows → 根据 CurrentPage 和 PageSize 计算切片区间 → 取出当前页数据赋给 DataSource → DataGridView 刷新绑定。每一行命令都走同一个流程，翻页按钮只是改 CurrentPage 后重新触发一次数据加载。理解了这条数据流，后面不管是用 DataTable 还是 List ，本质都一样。

// 分页数据源类的核心成员示意 public class PagedDataSource { private DataTable _sourceData; // 全量数据缓存 public int PageSize { get; set; } // 每页行数，默认20 public int CurrentPage { get; set; } // 当前页，从1开始 public int TotalRows { get; private set; } // 总行数 public int TotalPages { get { return (int)Math.Ceiling((double)TotalRows / PageSize); } } // 取当前页数据：用 Rows.Cast 做切片，返回一个新的 DataTable public DataTable GetCurrentPageData() { DataTable result = _sourceData.Clone(); // 克隆结构，不含数据 int startRow = (CurrentPage - 1) * PageSize; int endRow = Math.Min(startRow + PageSize, TotalRows); for (int i = startRow; i < endRow; i++) { result.ImportRow(_sourceData.Rows[i]); } return result; } }

这里的 GetCurrentPageData 是假分页的核心实现。用 Clone 而不是 Copy 是为了避免把全量数据再复制一遍，Clone 只复制表结构，然后用 ImportRow 逐行导入当前页的数据。很多新手直接在上面调用 Copy 方法，数据量一大就会卡，因为 Copy 把整个表连同数据复制了一遍，内存瞬间翻倍。startRow 和 endRow 的计算要特别注意，CurrentPage 从 1 开始，所以起始行是 (CurrentPage - 1) * PageSize 而不是 CurrentPage * PageSize，这个越界问题在跳页时最容易翻车，后面避坑章节会专门说。

3. 核心实现：翻页按钮、页码计算与状态同步

3.1 用户控件里的事件设计

分页控件的界面层是典型的 WinForm 用户控件组合：一个 TableLayoutPanel 放下四个按钮（首页、上一页、下一页、末页）、一个显示当前页/总页数的 Label、一个用于跳页的 TextBox 外加一个跳转按钮。这些控件的布局大同小异，重点在事件设计。

控件的对外接口不只是暴露属性，更重要的是翻页事件。标准做法是定义一个PageChanged事件，每当 CurrentPage 变化时触发。外部窗体订阅这个事件，在事件里重新拿数据、绑 DataGridView。这层解耦让控件本身不关心数据来自哪里——可以是 DataTable，可以是 List ，甚至可以是数据库查询。

// 用户控件中的翻页事件定义与触发 public event EventHandler PageChanged; private void btnNext_Click(object sender, EventArgs e) { if (_dataSource.CurrentPage < _dataSource.TotalPages) { _dataSource.CurrentPage++; UpdateButtonStates(); // 更新按钮可用状态 PageChanged?.Invoke(this, EventArgs.Empty); // 触发翻页事件 } } private void btnFirst_Click(object sender, EventArgs e) { if (_dataSource.CurrentPage != 1) { _dataSource.CurrentPage = 1; UpdateButtonStates(); PageChanged?.Invoke(this, EventArgs.Empty); } }

参数说明：PageChanged 事件不携带额外数据，因为外部窗体可以直接通过控件的 DataSource 属性拿到当前页数据。?.Invoke是 C# 6 的空条件运算符，表示如果事件没有订阅者就直接跳过，避免抛 NullReferenceException。UpdateButtonStates 方法是在每次页码变化后判断四个按钮的可用状态——当前页等于 1 时首页和上一页要置灰，当前页等于总页数时下一页和末页要置灰。这个状态同步漏了，用户会在第一页还疯狂点上一页，虽然逻辑上不会出错，但体验很差。

3.2 页码跳转与输入校验

除了四个翻页按钮，页码跳转框也是必不可少的功能。用户输入一个数字点跳转，直接把 CurrentPage 改成目标页码，然后触发 PageChanged。这个模块看着简单，但输入校验做不好会在用户输入 0、负数、非数字字符时直接抛异常。我一般会在跳转方法里做三重校验：先 TryParse 判断是否为整数，再判断是否在 1 到 TotalPages 之间，最后判断是否和当前页重复以减少无谓的页面刷新。

private void btnJump_Click(object sender, EventArgs e) { if (int.TryParse(txtPageNum.Text.Trim(), out int targetPage)) { if (targetPage >= 1 && targetPage <= _dataSource.TotalPages) { if (targetPage != _dataSource.CurrentPage) { _dataSource.CurrentPage = targetPage; UpdateButtonStates(); PageChanged?.Invoke(this, EventArgs.Empty); } } else { MessageBox.Show($"页码必须在 1 到 {_dataSource.TotalPages} 之间"); } } else { MessageBox.Show("请输入有效的页码"); } }

这段代码的逻辑说明：TryParse 失败说明用户输入了字母、符号或空字符串，直接弹提示；解析成功后做范围判断，防止用户跳转到不存在的页码；最后判断 targetPage 是否等于当前页，相等就直接 return，避免重复刷新 DataGridView 导致视觉上的闪烁。值得一提的细节是 txtPageNum.Text.Trim() 方法，用户经常输入" 3 "这种带空格的内容，不 Trim 的话 TryParse 虽然也能解析，但后面做字符串比较或者日志记录时会很不方便。参数说明上，把 MessageBox 提示文案里的页码范围动态拼进去，比写死一个数字更友好，也方便控件复用。

3.3 按钮状态联动与界面刷新

翻页控件里最容易忽略的是数据和按钮状态的联动逻辑。当外部传入新的数据源时，TotalRows 会变化，导致总页数变化，这时如果当前页大于新的总页数，不做修正就会导致 DataGridView 显示空白甚至越界报错。我在控件的公开方法里专门做了这个处理。

public void SetDataSource(DataTable data) { if (data == null) { _dataSource.TotalRows = 0; _dataSource.CurrentPage = 1; return; } _dataSource.TotalRows = data.Rows.Count; if (_dataSource.CurrentPage > _dataSource.TotalPages) { _dataSource.CurrentPage = _dataSource.TotalPages; } UpdateButtonStates(); lblPageInfo.Text = $"{_dataSource.CurrentPage} / {_dataSource.TotalPages}"; PageChanged?.Invoke(this, EventArgs.Empty); }

这里有个关键的边界场景：如果外部传入空表，TotalRows 是 0，TotalPages 通过 Math.Ceiling 算出来也是 0，如果此时 CurrentPage 还停留在 1，那么 1 > 0 成立，CurrentPage 会被修正为 0，这就出问题了。所以要在 TotalRows 为 0 时直接把 CurrentPage 重置为 1。反过来，如果数据从 100 行被替换成 10 行，原来的第 5 页就不存在了，修正逻辑会把当前页修正为新的总页数。这段修正逻辑看似不起眼，但少了它，分页控件在数据动态更新的表单场景里必现翻车。

4. 把分页控件接到项目里：绑定数据源与事件处理完整流程

4.1 从零开始绑定一个 DataTable

拿到这份分页控件资源后，第一步应该是把它当作普通 UserControl 拖到窗体上，然后写绑定逻辑。下面是最小可用的接入代码，先跑通流程再谈优化。

// 窗体 Load 事件里的最小接入代码 private void FormMain_Load(object sender, EventArgs e) { DataTable allData = GetDataFromDb(); // 获取全量数据，假设有5000行 pagerControl1.SetDataSource(allData); // 先设置数据源，计算总页数 pagerControl1.PageChanged += PagerControl1_PageChanged; // 再订阅翻页事件 } private void PagerControl1_PageChanged(object sender, EventArgs e) { dataGridView1.DataSource = pagerControl1.DataSource; // DataSource 就是当前页数据 }

这段代码的顺序很重要。先 SetDataSource 再订阅 PageChanged，是因为 SetDataSource 内部会触发一次 PageChanged 事件，如果先订阅，就会在窗体还没初始化完成时提前刷新 DataGridView。按我上面写的顺序，第一次 PageChanged 触发时还没有订阅者，不会执行任何代码；当用户真正点击翻页按钮时，事件才会被处理。DataSource 属性从控件内部取的已经是当前页的切片结果，直接赋给 DataGridView 即可。这个最小接入流程适用于大多数业务场景，不需要额外写复杂的翻页逻辑。

4.2 与 Dapper 配合做服务端分页

当数据量超过几万行时，假分页方案的内存压力会越来越大。此时配合 Dapper 这类轻量级 ORM 做服务端分页是更稳妥的方案。控件的数据源类不需要改，只需把 SetDataSource 换成异步查询的结果即可。核心是把翻页事件里的数据获取方式改成只查当前页数据。

// 配合 Dapper + SQL Server 做服务端分页 private async void PagerControl1_PageChanged(object sender, EventArgs e) { int pageSize = pagerControl1.PageSize; int currentPage = pagerControl1.CurrentPage; int offset = (currentPage - 1) * pageSize; using (IDbConnection conn = new SqlConnection(_connString)) { string sql = @" SELECT COUNT(*) FROM Orders WHERE OrderDate >= @startDate; SELECT * FROM Orders WHERE OrderDate >= @startDate ORDER BY OrderId OFFSET @offset ROWS FETCH NEXT @pageSize ROWS ONLY;"; using (var multi = await conn.QueryMultipleAsync(sql, new { startDate = _startDate, offset = offset, pageSize = pageSize })) { int totalRows = multi.ReadFirst<int>(); var pageData = multi.Read<Order>().ToList(); pagerControl1.SetDataSource(totalRows, pageData); } } dataGridView1.DataSource = pagerControl1.DataSource; }

这里 SetDataSource 变成了带两个参数的重载：第一个是总行数，第二个是当前页的数据集合。这样做的前提是控件的数据源类支持「只切片不缓存全量数据」的模式——即 CurrentPage 变化时不再从内部缓存取数，而是用外部传入的当前页数据。参数说明：OFFSET/FETCH 语法是 SQL Server 2012 及以上版本才支持的，老版本得换成 ROW_NUMBER() 窗口函数。offset 的计算规则和假分页完全一致，都是 (currentPage - 1) * pageSize。另外注意我用的是 QueryMultipleAsync 一次取两个结果集，避免执行两次 round-trip，这在数据量大的场景下能明显减少查询耗时。

4.3 绑定 List<T> 场景的注意事项

很多新手以为分页控件只能处理 DataTable，实际上只要把数据源类的内部逻辑改成泛型集合即可。绑定 List 时有个常见的隐性坑：直接用 ToList() 切片得到的是新的 List，每翻一页就 new 一次，如果数据行的对象很大（比如包含几十个字段的实体），翻页时的 GC 压力会非常大。我一般会复用一个 List 实例，翻页时先 Clear() 再 AddRange()，避免频繁触发垃圾回收。

private List<Order> _pageCache = new List<Order>(); // 复用的容器 private void UpdateGridWithList() { _pageCache.Clear(); _pageCache.AddRange(_allOrders .Skip((pagerControl1.CurrentPage - 1) * pagerControl1.PageSize) .Take(pagerControl1.PageSize)); dataGridView1.DataSource = new BindingList<Order>(_pageCache); }

这段代码里 Skip 和 Take 是 LINQ 的经典组合，效果等于 SQL 里的 OFFSET/FETCH。绑定时用 BindingList 而不是直接赋 List ，好处是后续如果对 DataGridView 做了排序或修改操作，BindingList 能自动通知界面刷新，体验更贴近原生 DataGridView 的行为。参数说明：这里假设 _allOrders 已经全量加载到内存中，如果是 List 加手动分页的组合，需要特别注意 Skip 对性能的影响——Skip 在大集合上并不总是 O(1)，它对每个元素都要做一次迭代判断，但对一万行以内的数据来说完全无感。

5. 常见问题与避坑：翻页乱跳、卡顿、绑定失效的排查记录

5.1 翻页后 DataGridView 自动滚动到最底部或选中行丢失

现象：点击下一页后，DataGridView 总是停在表格末尾，或者之前选中的行高亮消失，用户需要重新找当前行。

原因：DataGridView 的 CurrentCell 是跟着数据源的行索引走的。翻页后数据源换成了新切片，行索引 0 对应的数据已经变了，控件仍然尝试保持旧的 CurrentCell 位置，表现就是滚动条跳到奇怪的位置。而选中行高亮丢失是因为 CurrentCell 变成了 null。

解决：在 PageChanged 事件里手动设置 CurrentCell 到第一行，并调用 ClearSelection 避免多选高亮残留。

private void PagerControl1_PageChanged(object sender, EventArgs e) { dataGridView1.DataSource = pagerControl1.DataSource; // 强制选中第一行，并把滚动条拉回顶部 if (dataGridView1.Rows.Count > 0) { dataGridView1.CurrentCell = dataGridView1.Rows[0].Cells[0]; dataGridView1.ClearSelection(); } }

为什么加 ClearSelection：直接设置 CurrentCell 后，DataGridView 默认会同时选中整行，视觉上是高亮的，但假如上一次操作遗留了多行选中，新数据和旧行索引叠加会出现多行高亮的怪现象。ClearSelection 可以先把旧状态清掉，再让 CurrentCell 的设置生效。从那以后我每次接入分页控件，都会在写事件处理的时候把这段复制进去。

5.2 假分页方案下数据量一大内存就暴涨

现象：绑定了 5 万行数据后，程序内存从 80MB 飙到 400MB，翻页越来越慢，最后直接卡死。

原因：假分页把全量数据留在内存里，这个设计本身没错，但大多数实现是每次翻页时先 DataTable.Copy() 一份再切片，Copy 等于把全量数据完整复制了一遍，内存峰值翻倍。

解决：改用 Clone + ImportRow 的切片方式，见第 2 章的 GetCurrentPageData 代码。另外 DataTable 本身比 List 重很多，能换成 List 就换。

这里有个额外的血泪经验：如果你的 DataTable 里有 DateTime 或 decimal 类型的列，Clone 后 ImportRow 会自动做类型转换，偶尔会有精度差异。如果你发现翻页后某一列的值变了，先把数据源换成 List 试一下，基本能定位是不是 DataTable 内置的隐式转换在作怪。

5.3 翻页事件里频繁操作 DataGridView 导致界面闪烁

现象：快速点击下一页时，DataGridView 出现明显的白色闪烁，像在刷屏。

原因：每次翻页都先 DataSource = null 再重新赋值，或者 DataGridView 的刷新没有用双缓冲。

解决：不要主动置空 DataSource，直接赋新值；同时给控件开启双缓冲。

// 在窗体构造函数里对 DataGridView 开启双缓冲（WinForm 未开放此属性，需反射） typeof(DataGridView) .GetProperty("DoubleBuffered", System.Reflection.BindingFlags.Instance | System.Reflection.BindingFlags.NonPublic) ?.SetValue(dataGridView1, true);

参数说明：这是 WinForm 的一个老玄学，DoubleBuffered 属性在 Control 基类里是 protected 的，DataGridView 没有公开暴露，但反射能打开。开了双缓冲之后，快速翻页基本不会闪了。另外如果你的翻页事件里做了耗时操作，界面是会假死的，这种情况要用异步方式加载数据，别在主线程上卡着。

5.4 窗体 Load 事件里绑定分页控件后第一次翻页失效

现象：按上一页或下一页按钮没反应，第二次点才正常，或者第一次点击抛 NullReferenceException。

原因：窗体的 Load 事件里有太多初始化代码，分页控件的内部数据源还没初始化完成，PageChanged 事件就被触发了。更常见的是 SetDataSource 和 PageChanged 订阅的先后顺序搞反了。

解决：严格按第 4 章的接入顺序执行——先 SetDataSource 再订阅事件。同时把分页控件的初始化和数据绑定放到 Load 事件靠后的位置，确保其他控件都创建完。

另外一个常见诱因：如果你在窗体的构造函数里给分页控件的 PageSize 赋值，但数据源还没建好，内部就会用默认值做计算。我习惯把 PageSize 等配置放在控件初始化之后的第一行，确保所有内部字段先进入有效状态。

5.5 跳页输入框输入页码后数据没刷新

现象：在页码输入框输入「5」，点了跳转按钮，界面没有任何变化。

原因：输入的页码恰好等于当前页。这其实是逻辑上的正常行为——跳转方法做了「如果相同则 return」的优化，但界面上没有给用户任何提示，看着就像失效了。

解决：在跳转判断里加一个反馈，当页码相同时弹一条提示，或者把输入框清空换一个默认提示文案。从产品角度看，用户“跳转到当前页”是没有实际意义的操作，但你需要让界面响应，否则用户以为系统出 bug 了。我一般会顺手把输入框选中文本，方便用户直接改数字。

6. 进阶：分页控件的状态栏联动与视觉优化

6.1 状态栏显示加载进度与总页数

分页控件可以配合窗体底部的 StatusStrip 把当前状态实时同步到状态栏，这对应了很多项目里常见的「实时更新状态栏与进度条」需求。每次 PageChanged 时更新状态栏文本，显示当前页、总页数、当前页数据条数三个信息。

private void PagerControl1_PageChanged(object sender, EventArgs e) { toolStripStatusLabel1.Text = $"{pagerControl1.CurrentPage}/{pagerControl1.TotalPages} 页"; toolStripStatusLabel2.Text = $"本页 {dataGridView1.Rows.Count} 条"; }

如果翻页查数据库耗时超过 200ms，我建议在进度条上做个加载状态——翻页开始显示 Marquee 样式进度条，数据回来切回普通状态。不需要引入第三方控件，StatusStrip 自带的 ToolStripProgressBar 就够用，设置 Style 为 Marquee 即可。注意别在主线程同步查询时做这个，否则进度条根本转不动，所谓“进度反馈”完全失效。

6.2 按钮图标与配色微调

默认分页控件的按钮是纯文本的「首页/上一页/下一页/末页」。想做得更接近现代界面风格，可以把按钮的 FlatStyle 改为 Flat，用 Image 属性挂上四个方向箭头图标，并用视觉差做 hover 效果。这些改动全部在用户控件内部完成，不需要动外部调用代码。配色上建议用浅灰底 + 深色文字的经典组合，不要用高饱和颜色，办公场景里高饱和蓝紫色按钮很扎眼。

6.3 主从表场景的分页联动

最后说一个实际项目里大概率碰到的场景：左侧客户列表用的是分页控件，右侧订单明细跟着左侧选中客户联动的整体刷新。这种主从联动一定要把分页控件的 TotalRows 和 CurrentPage 重置逻辑用好——切换客户时先重置页码到 1，再重新 SetDataSource，否则上一个客户停留在第 10 页，切到下一个客户后控件会尝试取第 10 页的数据，新客户总共就 3 页，修正逻辑虽然能兜底，但会白白多一次查询。从那以后我每次切换主表记录，都强制按「重置页码 → 刷新数据 → 更新状态栏」的顺序走一遍，这套顺序在多个项目里都没翻过车，希望帮到你。

本文还有配套的精品资源，点击获取