C# WinForm DataGridView 单元格合并实战：自绘方案与避坑指南

简介这份资源面向使用 C# 开发 Windows Forms 应用的开发者聚焦 DataGridView 控件中单元格合并与二维表头创建这两个常见但实现门槛较高的需求。包内共 48 个文件以 16 个 cs 源码文件为核心配合 resx、resources 资源文件、sln 与 csproj 工程文件、exe 可执行程序及 pdb 调试文件另有少量 gif 演示图与 txt 说明压缩包约 97KB结构完整可直接运行调试。已有 870 人学习下载说明该主题在实际项目中具有较高参考价值。资源通过示例代码演示了基于 DataGridViewCellRange 的单元格合并思路以及借助自定义绘制事件构建多层表头的实现方式读者可据此理解合并范围计算、表头样式设置与分割线绘制等关键环节并在此基础上扩展动态表头、异常处理等场景快速应用到报表、统计表等数据展示界面中。1. 单元格合并这件事WinForm 老项目里绕不开的硬骨头做 C# WinForm 的同行大概率都碰过这种需求一张 DataGridView 展示订单明细同一个订单号下面挂着五六行商品产品经理看了一眼就说“把订单号那列合并一下看着清爽”。你打开属性面板翻了一圈发现 DataGridView 压根没有MergeCells这种属性。这不是你眼瞎是它真没有。DataGridView 从 .NET Framework 2.0 到现在原生就不支持单元格合并微软给的路子是自己在CellPainting事件里画或者干脆换控件。所以“DataGridView 单元格合并”这个搜索词背后站着的是一群被报表界面逼到墙角的 C# 开发者。这篇笔记拆的就是一套能直接落地的合并方案它解决的是同值单元格纵向合并、跨行显示、边框对齐、选中态错乱这一串连锁问题适合正在维护 WinForm 报表、台账、明细表的老手也适合刚接手一个祖传 C# 项目、被要求“界面优化一下”的新人。下面按“原理怎么立住 → 代码怎么抄 → 坑怎么躲”的顺序推。2. 合并的底层逻辑为什么不能改单元格只能重画2.1 DataGridView 的绘制模型决定了合并必须走自绘要理解为什么合并难做得先知道 DataGridView 是怎么把一个个格子摆到屏幕上的。它内部维护的是一个严格的行列矩阵每个DataGridViewCell对应唯一的(RowIndex, ColumnIndex)坐标GetCellDisplayRectangle返回的永远是单个格子的矩形。这个模型里没有“一个格子占两行”的概念你没法把两个 Cell 对象焊在一起。那合并是怎么实现的答案是不改数据结构只改绘制和命中测试。具体说当一列里连续若干行的值相同时我们让最上面那个格子正常显示文字下面几个格子的文字不画同时把边框线擦掉视觉上就连成了一块。选中、点击这些交互再通过重写命中逻辑把坐标映射回“主单元格”。这套思路在CellPainting事件里就能落地不需要继承控件改造成本最低。常见做法是监听CellPainting判断当前格是不是“被合并的从属格”是的话用背景色刷一遍、跳过文字绘制。这里有个关键参数e.Handled true。一旦设了它DataGridView 就不再执行默认绘制你的画法完全接管。忘了设默认边框和文字会盖在你的背景上出现重影。2.2 先排序再合并否则合并逻辑全是玄学合并的前提是相同值必须物理相邻。如果数据源没排序同一个订单号散落在第 3 行和第 87 行你的合并算法要么漏合并要么把中间不相干的行也吞进去。所以第一步永远是排序而且排序要稳定。我一般会在绑定数据前用 LINQ 按合并列做一次OrderBy把相同值的行聚到一起。如果业务要求保持原始录入顺序那就得换思路——用分组索引而不是简单相邻判断。下面这段是排序加分组标记的预处理// 假设 dt 是已经填充好的 DataTable按 OrderNo 聚拢 var sorted dt.AsEnumerable() .OrderBy(r r.Fieldstring(OrderNo)) .ThenBy(r r.Fieldint(LineNo)) // 同订单内保持明细顺序 .CopyToDataTable(); grid.DataSource sorted; // 预先算好每一行在合并列上的“跨度”避免在绘制事件里反复扫描 var spanMap new Dictionaryint, int(); // 行号 - 该合并块的总行数 int i 0; while (i sorted.Rows.Count) { int j i 1; string key sorted.Rows[i][OrderNo].ToString(); while (j sorted.Rows.Count sorted.Rows[j][OrderNo].ToString() key) j; spanMap[i] j - i; // 只有块的首行记录跨度 i j; }逻辑说明OrderBy保证相邻ThenBy保证同组内明细不乱序。spanMap只记录每个合并块首行的行号和块大小绘制时判断“当前行是不是某个块的首行”就够了不用每画一个格子都从头扫一遍。参数上OrderBy的字段必须和你要合并的列一致多个合并列就多级排序。CopyToDataTable在空结果时会抛异常数据可能为空的话加个Any()判断。2.3 用 CellPainting 擦掉从属格的边框和文字预处理做完进入绘制环节。核心判断只有一句当前格所在行是不是某个合并块的首行不是就说明它是从属格需要被“抹掉”。private Dictionaryint, int _spanMap; // 由 2.2 传入 private string _mergeColumn OrderNo; private void Grid_CellPainting(object sender, DataGridViewCellPaintingEventArgs e) { if (e.RowIndex 0 || e.ColumnIndex 0) return; if (grid.Columns[e.ColumnIndex].Name ! _mergeColumn) return; // 找到当前行所属合并块的首行 int headRow -1; foreach (var kv in _spanMap) { if (e.RowIndex kv.Key e.RowIndex kv.Key kv.Value) { headRow kv.Key; break; } } if (headRow 0) return; // 从属格只刷背景不画文字和边框 if (e.RowIndex ! headRow) { using (var brush new SolidBrush(e.CellStyle.BackColor)) e.Graphics.FillRectangle(brush, e.CellBounds); e.Handled true; return; } // 首行格正常画但要把下方边框去掉让块连起来 e.Paint(e.ClipBounds, DataGridViewPaintParts.All ~DataGridViewPaintParts.Border); using (var pen new Pen(grid.GridColor)) { var b e.CellBounds; e.Graphics.DrawLine(pen, b.Left, b.Top, b.Right, b.Top); // 上边 e.Graphics.DrawLine(pen, b.Left, b.Top, b.Left, b.Bottom); // 左边 e.Graphics.DrawLine(pen, b.Right - 1, b.Top, b.Right - 1, b.Bottom); // 右边 } e.Handled true; }逻辑说明从属格用背景色填满等于把文字和网格线一起盖掉首行格用Paint画全部内容但排除Border再手动补上左、上、右三条边底边故意不画视觉上就和下一行连成一体。参数上e.CellBounds是格子的屏幕矩形e.ClipBounds是裁剪区两者在滚动时可能不同用CellBounds填充更稳。grid.GridColor要和主题一致深色主题下记得换成对应颜色否则白线突兀。3. 把合并接进真实项目绑定、选中与滚动三处联动3.1 数据绑定后立刻重算跨度别等绘制时算上面_spanMap是在绑定后算的但真实项目里数据会刷新——翻页、筛选、重新查询都会让DataSource变。如果只在Form_Load里算一次第二次查询后合并就错位了。正确做法是把重算逻辑抽成方法在DataBindingComplete事件里调用。private void Grid_DataBindingComplete(object sender, DataGridViewBindingCompleteEventArgs e) { RebuildSpanMap(); grid.Invalidate(); // 强制重绘否则旧画面残留 } private void RebuildSpanMap() { _spanMap new Dictionaryint, int(); if (grid.Rows.Count 0) return; int colIdx grid.Columns[_mergeColumn].Index; int i 0; while (i grid.Rows.Count) { string key grid.Rows[i].Cells[colIdx].Value?.ToString() ?? ; int j i 1; while (j grid.Rows.Count (grid.Rows[j].Cells[colIdx].Value?.ToString() ?? ) key) j; if (j - i 1) _spanMap[i] j - i; // 只有真正多行才记 i j; } }逻辑说明DataBindingComplete在数据绑定完成后触发此时Rows已经就绪拿得到真实值。Invalidate()不能省否则 DataGridView 不会主动重画你会看到合并“慢半拍”。参数上Value?.ToString() ?? 处理了 DBNull 和 null空值行也会被当成一组合并——如果业务上空值不该合并这里加个if (key ) { i; continue; }。3.2 选中态和键盘导航合并后光标会“跳”合并做完用户一按方向键就发现问题光标从合并块首行往下走直接跳到块尾的下一行中间几行像被吞了。这是 DataGridView 默认导航逻辑在作祟它不知道你视觉上合并了。解决办法是拦截SelectionChanged或者重写SetSelectedCellCore把落在从属格上的选中强制拉回首行。private void Grid_SelectionChanged(object sender, EventArgs e) { if (grid.CurrentCell null) return; if (grid.Columns[grid.CurrentCell.ColumnIndex].Name ! _mergeColumn) return; int row grid.CurrentCell.RowIndex; foreach (var kv in _spanMap) { if (row kv.Key row kv.Key kv.Value) { grid.CurrentCell grid[kv.Key, grid.CurrentCell.ColumnIndex]; return; } } }逻辑说明只要当前选中的行落在某个合并块的“非首行”区间就把CurrentCell设回该块首行。注意这里用grid[colIndex, rowIndex]的索引顺序是列在前行在后写反了会取到别的格子。这个处理会让键盘导航“跳过”从属行符合视觉预期但如果你有逐行编辑需求就得改成允许进入从属格、只是不高亮。3.3 滚动与重绘双缓冲治闪烁合并块多了以后滚动时画面会闪尤其是从属格被反复填充背景。这是 WinForm 自绘的老毛病开双缓冲能压下去。DataGridView 的双缓冲不是公开属性得靠反射或者继承。// 方式一反射开启不改控件类型最省事 typeof(DataGridView) .GetProperty(DoubleBuffered, System.Reflection.BindingFlags.Instance | System.Reflection.BindingFlags.NonPublic) .SetValue(grid, true, null);逻辑说明DoubleBuffered是Control的保护属性DataGridView 没暴露出来反射是常见绕法。放在窗体构造函数里、InitializeComponent之后执行。参数上第二个SetValue的true就是开启null是索引器参数属性不是索引器所以传 null。如果项目规范禁止反射就继承一个DataGridView子类在构造函数里设DoubleBuffered true然后设计器里把控件类型换掉。4. 避坑排查合并做完了为什么还是不对劲4.1 合并后边框错位块与块之间多一条线现象合并块内部干净了但相邻两个块之间出现双线或者线宽不一致。原因通常是首行格手动补边时底边没画而下一个块的首行又画了上边两条线叠在一起。解决统一约定“每个块只画上、左、右底边交给下一个块的上边”或者干脆全部用e.Paint画完再擦内部横线。我一般选前者逻辑简单。4.2 排序字段和合并字段不一致导致漏合并现象明明值相同的行没合并。原因OrderBy用的字段和_mergeColumn指向的列不是同一个或者排序时做了Trim而合并判断没做。解决排序和合并判断必须用完全相同的取值表达式建议抽一个GetMergeKey(row)方法两边共用避免手滑。4.3 数据量大时绘制卡顿现象几千行数据滚动像幻灯片。原因CellPainting里每次都在遍历_spanMap找首行复杂度是 O(n)。解决把_spanMap换成按行号索引的数组int[] headOfRow预处理时直接填好每一行对应的首行号绘制时 O(1) 查表。这个优化在 5000 行以上差别非常明显。4.4 导出 Excel 时合并丢失现象界面合并得好好的导出到 Excel 全散开了。原因合并只是绘制层的事数据层还是逐行的。解决导出时单独走一遍分组逻辑用 Excel 的Range.Merge()按同样的跨度合并。别指望界面状态能带过去这是两套东西。4.5 编辑态下从属格被激活现象双击合并块中间光标进了从属格输入的文字看不见。原因CellPainting只管画不管编辑权限。解决在CellBeginEdit事件里判断如果当前格是从属格就e.Cancel true把编辑引导到首行格。5. 进阶把合并逻辑抽成可复用组件与验证清单写到这儿合并本身已经能跑了。但每个报表窗体都复制一遍CellPainting、SelectionChanged、RebuildSpanMap维护起来是灾难。我的习惯是抽一个GridMergeHelper类构造时传入 DataGridView 和合并列名内部挂事件、管状态窗体里一行代码接入。public class GridMergeHelper { private readonly DataGridView _grid; private readonly string _column; private int[] _headOfRow; // 每行对应的块首行号-1 表示不合并 public GridMergeHelper(DataGridView grid, string column) { _grid grid; _column column; _grid.CellPainting OnPaint; _grid.DataBindingComplete (s, e) { Rebuild(); _grid.Invalidate(); }; _grid.SelectionChanged OnSelection; _grid.CellBeginEdit OnBeginEdit; } private void Rebuild() { int n _grid.Rows.Count; _headOfRow new int[n]; for (int k 0; k n; k) _headOfRow[k] k; if (n 0) return; int col _grid.Columns[_column].Index; int i 0; while (i n) { string key _grid.Rows[i].Cells[col].Value?.ToString() ?? ; int j i 1; while (j n (_grid.Rows[j].Cells[col].Value?.ToString() ?? ) key) j; for (int k i 1; k j; k) _headOfRow[k] i; i j; } } // OnPaint / OnSelection / OnBeginEdit 略逻辑同前文 }逻辑说明_headOfRow数组把查找从 O(n) 降到 O(1)Rebuild在每次数据绑定后重建。事件订阅集中在构造函数窗体销毁时记得Dispose里退订否则内存泄漏。参数上_column是列名不是列索引因为列顺序可能被用户拖动改变用名字更稳。接入之后怎么验证没翻车我固定跑这几条一是空数据源绑定不报错二是单行数据不触发合并、边框正常三是全列同值时整列合并成一块四是排序后合并块跟着重排五是键盘上下键导航不卡在从属行六是导出 Excel 的合并跨度和界面一致。这六条过一遍基本能挡住 90% 的回归问题。说个血泪经验早年间我在一个项目里图省事把合并逻辑直接写在窗体的CellPainting里没抽组件。后来需求加了三个报表每个都复制粘贴改一个 bug 要改三处漏了一处就线上翻车。从那以后我每次做 DataGridView 合并都强制先抽 Helper、再写窗体验证清单也固定走一遍。希望帮到你。本文还有配套的精品资源点击获取