简介：本资源是一份面向C#初学者与Windows Forms开发者的实用源码示例，聚焦解决DataGridView控件中单元格合并这一高频界面定制需求。代码基于Visual Studio 2008环境编写，完整实现了跨行/跨列合并逻辑，适用于报表展示、数据汇总等需提升可读性的数据库应用界面场景。压缩包共12个文件，含6个核心.cs源文件（含主窗体、合并逻辑类及数据绑定处理）、2个.resx本地化资源文件、1个.sln解决方案与1个.csproj项目文件，结构清晰，便于直接导入VS工程调试学习；整体仅14KB，轻量易用。已有3241人下载学习，读者可获取完整的合并单元格实现方案，包括自定义绘制逻辑、行列跨度计算、鼠标悬停提示适配及与BindingSource的数据联动机制，即使数据库文件缺失，亦可通过源码反向构建测试环境，快速掌握该功能的底层原理与工程化落地方法。
1. C#在DataGridView控件中实现合并单元格：不是靠重绘黑匣子，而是用CellPainting+自定义RowSpan逻辑落地的真工况方案
你有没有遇到过这种场景：用C# WinForms开发内部数据看板时，数据库查出的订单明细表里，同一客户名下十几条记录连续排列，但“客户名称”列重复写了十几次——领导扫一眼就皱眉：“这UI太啰嗦，得把相同客户名合并成一行”。可翻遍DataGridView官方文档，压根没有MergeCells = true这种属性；网上搜到的所谓“合并方案”，要么是重写整个控件、要么依赖第三方库、要么只在Demo里跑通，一上真实业务数据（含空值、分页、排序、编辑态）就翻车。这不是玄学，是WinForms里被长期低估的渲染层控制权问题。本文拆解的是一套已在某高校教务系统、某制造企业MES报表模块中稳定运行3年以上的纯原生C#实现方案：不引用任何外部DLL，不修改DataGridView基类，仅通过CellPainting事件拦截绘制、配合RowSpan状态缓存与MouseDown坐标映射，实现带编辑兼容、支持滚动刷新、可响应列宽变化的动态合并。适合需要交付可维护桌面端报表的开发者，尤其当你被要求“必须用原生WinForms，不能换WPF或Web”。
2. 合并原理与选型依据：为什么不用OwnerDrawFixed，而必须用CellPainting+状态机
2.1 DataGridView合并的本质矛盾：数据模型与视图渲染的错位
DataGridView本质是“行驱动”的列表控件，其DataSource绑定的是DataTable或BindingList<T>这类扁平化集合，天然不携带“某几行在某列应视为一个逻辑单元”的元信息。强行在数据层做合并（如预处理成GroupBy后的嵌套结构），会导致编辑回写失败、排序失效、筛选错乱——因为DataRowView的Row索引和原始数据行已脱钩。所以正确路径是在视图层拦截渲染指令，让视觉上“看起来合并”，而底层数据保持原样。这是所有可靠方案的共识起点。
2.2 为什么弃用OwnerDrawFixed？血泪经验告诉你它在哪翻车
早期我试过OwnerDrawFixed模式：设置DefaultCellStyle.BackColor = Color.Transparent，再在CellPainting里手动画背景和文字。但很快发现三个硬伤：
- 滚动撕裂：当快速拖动垂直滚动条时，
CellPainting事件触发顺序与实际屏幕刷新不同步，导致合并区域边缘出现1像素错位或残留色块； - 编辑态失联：进入单元格编辑模式（F2或点击）后，
EditingControl（如TextBox）的定位完全依赖DataGridView默认的GetCellDisplayRectangle计算，而OwnerDrawFixed绕过了该计算链路，导致编辑框悬浮在错误位置； - 列宽自适应失效：调用
AutoResizeColumn时，控件无法感知合并区域的真实内容宽度，常把长文本截断。
提示：
OwnerDrawFixed适用于静态只读表格（如帮助文档列表），但凡涉及用户交互，必须退回到CellPainting+DefaultCellStyle组合方案。
2.3 最终选定方案：CellPainting事件 + 行状态缓存 + 坐标映射
核心思路分三层：
- 状态层：用
Dictionary<int, int>缓存每行在目标列的“合并跨度”（RowSpan），键为起始行索引，值为跨越行数。例如第0行起始的客户名合并了3行，则spanMap[0] = 3； - 渲染层：在
CellPainting中，对目标列（如ColumnIndex == 0）判断当前行是否为合并块的首行（spanMap.ContainsKey(e.RowIndex)），若是则绘制完整背景+文字，并跳过后续行的绘制； - 交互层：重写
OnMouseDown，将鼠标坐标反向映射到逻辑行号（考虑合并后视觉行高变化），确保点击任意合并区域都能准确定位到首行数据。
这个方案的优势在于：完全复用DataGridView原生布局引擎，编辑、排序、筛选、滚动全部不受影响，唯一新增的是轻量级状态管理。
3. 核心代码实现：从初始化到CellPainting事件的完整闭环
3.1 初始化合并配置与状态缓存字典
在窗体构造函数或Load事件中完成基础配置：
// 声明状态缓存字典：key=首行索引，value=合并行数 private Dictionary<int, int> _rowSpanMap = new Dictionary<int, int>(); // 指定要合并的列索引（例如客户名称列） private readonly int _mergeColumnIndex = 0; // 启用CellPainting事件（必须！否则不触发自定义绘制） dataGridView1.CellPainting += DataGridView1_CellPainting; // 关键：禁用该列的默认绘制，否则会与自定义绘制重叠 dataGridView1.Columns[_mergeColumnIndex].DefaultCellStyle.BackColor = Color.White; dataGridView1.Columns[_mergeColumnIndex].DefaultCellStyle.SelectionBackColor = Color.LightBlue;逻辑说明：
_rowSpanMap是性能关键。它不在每次绘制时实时计算，而是在数据源变更（如BindingSource.ResetBindings()）或用户执行排序/筛选后主动重建。这样避免了CellPainting高频调用中的重复计算开销。参数_mergeColumnIndex需根据实际列序号调整，建议用列名获取：dataGridView1.Columns["CustomerName"].Index。
3.2 构建RowSpan映射：按业务规则生成合并区间
此方法在数据加载后、首次显示前调用，也可在BindingSource.ListChanged事件中触发：
private void BuildRowSpanMap() { _rowSpanMap.Clear(); if (dataGridView1.RowCount == 0) return; // 从第0行开始扫描 int currentStartRow = 0; while (currentStartRow < dataGridView1.RowCount) { object firstValue = dataGridView1[currentStartRow, _mergeColumnIndex].Value; int span = 1; // 至少包含自身 // 向下检查连续相同值的行数 int nextRow = currentStartRow + 1; while (nextRow < dataGridView1.RowCount) { object nextValue = dataGridView1[nextRow, _mergeColumnIndex].Value; // 注意：null值需特殊处理，避免NullReferenceException bool isEqual = firstValue == null ? nextValue == null : firstValue.Equals(nextValue); if (isEqual) { span++; nextRow++; } else { break; } } // 记录起始行与跨度 _rowSpanMap[currentStartRow] = span; currentStartRow = nextRow; // 跳到下一个合并块起始行 } }参数说明：
span值决定视觉合并高度。若span=1，表示该行无合并，按默认高度绘制；若span>1，则首行绘制时需拉伸背景并居中文字。此算法时间复杂度O(n)，对万级行数据实测耗时<5ms，可接受。
3.3 CellPainting事件主逻辑：绘制合并背景与文字
这是最核心的渲染环节，必须精确控制绘制区域：
private void DataGridView1_CellPainting(object sender, DataGridViewCellPaintingEventArgs e) { // 仅处理目标列且非标题行 if (e.ColumnIndex != _mergeColumnIndex || e.RowIndex < 0) return; // 若当前行是合并块首行，则绘制完整合并区域 if (_rowSpanMap.TryGetValue(e.RowIndex, out int span) && span > 1) { // 1. 计算合并区域的总高度（含所有参与行） int totalHeight = 0; for (int i = 0; i < span; i++) { totalHeight += dataGridView1.Rows[e.RowIndex + i].Height; } // 2. 获取首行单元格的显示矩形（左上角坐标+默认宽度） Rectangle cellRect = e.CellBounds; cellRect.Height = totalHeight; // 拉伸高度覆盖所有行 // 3. 绘制合并背景（使用列默认背景色） using (SolidBrush backBrush = new SolidBrush(e.CellStyle.BackColor)) { e.Graphics.FillRectangle(backBrush, cellRect); } // 4. 绘制边框（可选，增强视觉区分） using (Pen borderPen = new Pen(Color.FromArgb(220, 220, 220))) { e.Graphics.DrawRectangle(borderPen, cellRect.X, cellRect.Y, cellRect.Width - 1, cellRect.Height - 1); } // 5. 居中绘制文字（关键：垂直居中需计算偏移） string text = e.Value?.ToString() ?? ""; TextFormatFlags flags = TextFormatFlags.VerticalCenter | TextFormatFlags.HorizontalCenter | TextFormatFlags.WordEllipsis; TextRenderer.DrawText(e.Graphics, text, e.CellStyle.Font, cellRect, e.CellStyle.ForeColor, flags); // 6. 标记已处理，跳过后续行的绘制 e.Handled = true; return; } // 若当前行不是首行（即合并块中间行），则清空绘制，避免重复 if (e.RowIndex > 0 && _rowSpanMap.Any(kvp => kvp.Key < e.RowIndex && kvp.Key + kvp.Value > e.RowIndex)) { e.PaintBackground(e.ClipBounds, true); e.Handled = true; return; } }逻辑说明：
e.Handled = true是核心开关，它告诉DataGridView“本事件已处理完毕，无需执行默认绘制”。若遗漏此行，会出现文字重叠或背景错乱。TextRenderer.DrawText比Graphics.DrawString更符合WinForms原生风格，且自动处理字体缩放和省略号。cellRect.Height = totalHeight是实现视觉合并的关键赋值，它突破了单行高度限制。
4. 避坑指南：五个真实项目中踩过的坑与解决方案
4.1 现象：合并后鼠标悬停高亮失效，整行变色异常
原因：CellPainting中绘制了自定义背景，但未处理e.State.HasFlag(DataGridViewElementStates.Selected)状态，导致选中态样式被覆盖。
解决：在CellPainting中增加选中态判断，动态切换背景色：
Color backColor = e.State.HasFlag(DataGridViewElementStates.Selected) ? e.CellStyle.SelectionBackColor : e.CellStyle.BackColor; using (SolidBrush backBrush = new SolidBrush(backColor)) { e.Graphics.FillRectangle(backBrush, cellRect); }4.2 现象：数据源更新后（如新增一行），合并区域错位或消失
原因：_rowSpanMap未在数据变更后重建，仍沿用旧索引映射。
解决：监听BindingSource的ListChanged事件，在Reset或ItemAdded后强制重建：
bindingSource.ListChanged += (s, e) => { if (e.ListChangedType == ListChangedType.Reset || e.ListChangedType == ListChangedType.ItemAdded) { BuildRowSpanMap(); dataGridView1.Invalidate(); // 触发重绘 } };4.3 现象：列宽调整后，合并区域文字被截断或错位
原因：CellPainting中使用的cellRect基于原始列宽计算，列宽变化后e.CellBounds未实时更新。
解决：在ColumnWidthChanged事件中触发重绘，并确保BuildRowSpanMap在列宽变化后仍有效（因合并逻辑不依赖列宽）：
dataGridView1.ColumnWidthChanged += (s, e) => { if (e.ColumnIndex == _mergeColumnIndex) { dataGridView1.Invalidate(); // 仅重绘该列区域 } };4.4 现象：启用AutoSizeColumnsMode = Fill时，合并列宽度异常压缩
原因：Fill模式按权重分配宽度，但合并列的PreferredWidth未反映其视觉重要性。
解决：手动设置合并列的MinimumWidth和Width，并禁用其自动调整：
dataGridView1.Columns[_mergeColumnIndex].AutoSizeMode = DataGridViewAutoSizeColumnMode.None; dataGridView1.Columns[_mergeColumnIndex].MinimumWidth = 150; dataGridView1.Columns[_mergeColumnIndex].Width = 200; // 根据业务设定合理值4.5 现象：导出Excel时，合并单元格未生效，仍是分散行
原因：CellPainting仅影响屏幕渲染，不影响DataGridView导出逻辑（如CopyToClipboard或第三方导出库）。
解决：导出前临时生成新DataTable，对合并列进行物理合并（仅用于导出）：
private DataTable GetMergedExportTable() { DataTable exportTable = new DataTable(); // 复制列结构... foreach (DataRowView rowView in bindingSource.List) { DataRow newRow = exportTable.NewRow(); // 对合并列：仅在首行写入值，其余行留空 if (_rowSpanMap.Keys.Contains(bindingSource.List.IndexOf(rowView))) { newRow["CustomerName"] = rowView["CustomerName"]; } else { newRow["CustomerName"] = DBNull.Value; } exportTable.Rows.Add(newRow); } return exportTable; }5. 编辑态兼容与交互增强：让合并单元格真正可用
5.1 点击定位：将鼠标坐标映射到逻辑首行
合并后视觉上是一个大单元格，但用户点击任意位置都应选中首行数据。需重写OnMouseDown：
protected override void OnMouseDown(MouseEventArgs e) { base.OnMouseDown(e); // 判断是否点击在合并列内 var hitTest = dataGridView1.HitTest(e.X, e.Y); if (hitTest.ColumnIndex == _mergeColumnIndex && hitTest.RowIndex >= 0) { // 查找该视觉行对应的逻辑首行 int logicalRow = hitTest.RowIndex; foreach (var kvp in _rowSpanMap) { if (kvp.Key <= hitTest.RowIndex && hitTest.RowIndex < kvp.Key + kvp.Value) { logicalRow = kvp.Key; break; } } // 强制选中逻辑首行（取消多选，仅单行） dataGridView1.ClearSelection(); dataGridView1.CurrentCell = dataGridView1[_mergeColumnIndex, logicalRow]; dataGridView1.Rows[logicalRow].Selected = true; } }逻辑说明：
HitTest返回的是鼠标下的视觉行号，而_rowSpanMap存储的是逻辑行号映射关系。此段代码通过遍历字典，找到包含该视觉行号的合并区间，从而定位到首行。CurrentCell赋值确保编辑焦点准确落位。
5.2 键盘导航：方向键移动时跳过合并中间行
默认情况下，按↓键会逐行移动，导致光标停在合并块的中间行（无数据的“空行”）。需拦截PreviewKeyDown：
private void DataGridView1_PreviewKeyDown(object sender, PreviewKeyDownEventArgs e) { if (e.KeyCode == Keys.Down || e.KeyCode == Keys.Up) { int currentRow = dataGridView1.CurrentCell.RowIndex; int targetRow = e.KeyCode == Keys.Down ? currentRow + 1 : currentRow - 1; // 若目标行属于某个合并块的中间行，则跳转到下一个/上一个合并块首行 if (targetRow >= 0 && targetRow < dataGridView1.RowCount) { foreach (var kvp in _rowSpanMap) { if (kvp.Key < targetRow && targetRow < kvp.Key + kvp.Value) { // 找到中间行，修正为边界行 targetRow = e.KeyCode == Keys.Down ? kvp.Key + kvp.Value : kvp.Key; break; } } } if (targetRow >= 0 && targetRow < dataGridView1.RowCount) { dataGridView1.CurrentCell = dataGridView1[dataGridView1.CurrentCell.ColumnIndex, targetRow]; } e.IsInputKey = true; // 消费该按键，防止默认行为 } }5.3 排序与筛选后的自动重建策略
合并状态必须随数据视图变化而动态更新。关键点在于：
- 排序：
BindingSource.Sort后，ListChanged事件会触发Reset，BuildRowSpanMap()自动重建； - 筛选：
BindingSource.Filter后，同样触发Reset，但需注意Filter可能使RowCount突变，BuildRowSpanMap()中的while循环已适配此场景； - 验证：可在
Sorted或FilterChanged事件中添加日志，确认重建时机：
bindingSource.SortChanged += (s, e) => Debug.WriteLine($"Sort changed, rebuilding span map..."); bindingSource.FilterChanged += (s, e) => Debug.WriteLine($"Filter changed, rebuilding span map...");实战技巧：某制造企业MES报表曾因筛选后未重建
_rowSpanMap，导致合并显示错乱。后来我们加了一行防御性代码：在CellPainting开头强制校验_rowSpanMap.Count是否等于当前RowCount，不等则立即重建并警告。这成了我们团队的标配检查项。
6. 进阶技巧：支持多列合并与动态列选择的工厂模式封装
6.1 多列合并的扩展设计：用二维状态映射替代单列字典
当业务需要同时合并“客户名称”和“产品类别”两列时，单Dictionary<int, int>不够用。升级为Dictionary<(int colIndex, int rowIndex), int>，键为列行元组：
private Dictionary<(int col, int row), int> _multiSpanMap = new Dictionary<(int, int), int>(); // 构建时遍历所有目标列 private void BuildMultiSpanMap(int[] mergeColumnIndices) { _multiSpanMap.Clear(); foreach (int colIndex in mergeColumnIndices) { int currentStartRow = 0; while (currentStartRow < dataGridView1.RowCount) { object firstValue = dataGridView1[currentStartRow, colIndex].Value; int span = 1; int nextRow = currentStartRow + 1; while (nextRow < dataGridView1.RowCount) { object nextValue = dataGridView1[nextRow, colIndex].Value; bool isEqual = firstValue == null ? nextValue == null : firstValue.Equals(nextValue); if (isEqual) { span++; nextRow++; } else break; } _multiSpanMap[(colIndex, currentStartRow)] = span; currentStartRow = nextRow; } } }优势：支持任意列组合，且各列合并逻辑独立。
CellPainting中只需判断_multiSpanMap.TryGetValue((e.ColumnIndex, e.RowIndex), out int span)即可。
6.2 动态列选择：通过属性面板配置合并列
为提升复用性，将合并列索引抽象为DataGridView的扩展属性：
public static class DataGridViewExtensions { private static readonly object MergeColumnsKey = new object(); public static int[] GetMergeColumns(this DataGridView dgv) { return (int[])dgv.Tag?.GetType().GetProperty("MergeColumns")?.GetValue(dgv.Tag) ?? new int[0]; } public static void SetMergeColumns(this DataGridView dgv, int[] columns) { if (dgv.Tag == null) dgv.Tag = new object(); var tagType = dgv.Tag.GetType(); var prop = tagType.GetProperty("MergeColumns"); if (prop != null) prop.SetValue(dgv.Tag, columns); } }在设计器中设置：dataGridView1.SetMergeColumns(new int[] {0, 2});—— 即客户名列和日期列同时合并。
6.3 性能优化：大数据量下的分块重建与懒加载
当RowCount > 10000时，BuildRowSpanMap()全量扫描可能卡顿。采用分块策略：
private void BuildSpanMapLazy(int startRow, int rowCount) { // 仅重建可视区域+缓冲区（如当前显示行±50行） int visibleStart = Math.Max(0, startRow - 50); int visibleEnd = Math.Min(dataGridView1.RowCount, startRow + rowCount + 50); // 清空旧映射中该范围内的记录 var keysToRemove = _rowSpanMap.Keys.Where(k => k >= visibleStart && k < visibleEnd).ToArray(); foreach (int key in keysToRemove) _rowSpanMap.Remove(key); // 重建该范围 int current = visibleStart; while (current < visibleEnd && current < dataGridView1.RowCount) { // ... 同前构建逻辑 ... current = nextRow; } } // 在Scroll事件中触发 dataGridView1.Scroll += (s, e) => { var firstVisibleRow = GetFirstVisibleRow(dataGridView1); BuildSpanMapLazy(firstVisibleRow, 100); // 重建100行 dataGridView1.Invalidate(); };从那以后我每次接手新报表需求，第一件事就是检查
DataGridView是否启用了DoubleBuffered（通过反射设置SetStyle(ControlStyles.OptimizedDoubleBuffer, true)），第二件事就是把BuildRowSpanMap()封装成可注入的策略类，第三件事——永远在CellPainting开头加一行if (_rowSpanMap.Count == 0) BuildRowSpanMap();作为后悔药。这三步下来，90%的合并翻车现场都能提前扼杀。希望帮到你。
本文还有配套的精品资源，点击获取
