简介这是一份面向C# WinForm开发者的DataGridView进阶示例工程专门解决表格单元格合并与样式定制的常见需求。资源基于.NET框架包含完整可运行的Windows窗体示例共30个文件以cs源文件、resx/resources资源文件为主另含exe可执行程序、pdb调试符号及txt说明文档压缩包大小仅65KB轻量易用。示例程序从合并概念入手演示通过MergeType属性实现同一列相同值的单元格自动合并同时介绍重写GetCellDisplayRectangle方法来自定义合并区域满足多行文本或组合信息展示场景。样式设置部分涵盖DefaultCellStyle字体、颜色和背景色控制奇偶行交替变色列头样式与边框样式调整并说明利用DefaultCellStyle.Clone()创建样式副本以避免污染默认样式以及在CellPainting等事件中绘制特殊效果。整套代码可直接迁移至实际WinForm项目中有效提升表格界面的美观度和可读性。该资源已有585人学习适合正在开发管理信息系统且希望增强DataGridView展示效果的初中级C#程序员参考。 前两天整理工作电脑翻出一个压箱底的DataGridView单元格合并及样式工具包就是那种改了几个版本的WinForms报表项目里必然会出现的东西。做C# WinForms的兄弟应该都有同感DataGridView这个控件从.NET 2.0一路用到.NET 8数据绑定、排序、筛选、虚拟模式样样顺手可一旦牵扯到“合并单元格”瞬间从天堂跌到地狱。尤其在做B端管理系统时排期表、报表汇总、导入数据预览几乎每个场景都要把表头或者内容行列合并一下。这篇文章就把我折腾这套方案的完整思路、核心代码、样式坑和排查经验一次性说清楚给正被合并单元格折磨的朋友一条可以直接抄作业的路。1. 合并单元格的底层逻辑与方案选型1.1 为什么DataGridView原生不支持合并先说个扎心的结论DataGridView从设计上就不支持跨行跨列的单元格合并。它本质是一张“等宽等高”的网格表每一行、每一列都严格按坐标排布单元格之间彼此独立数据也各自绑定在独立的Cell对象上。你可以设置RowSpan这样的“伪合并”属性来让某些区域看起来一样宽但真正的合并左上角一个单元格跨越多个行/列没有现成的API调用。这个问题不解决业务上就没法收场。比如下面这种常见的报表表头产品类别这一列的表头要跨3行显示本月销售和本年累计两个大类下面各挂两个子列数据区域里相邻几行的产品类别值相同需要合并成一个单元格显示原生控件里这三类需求全都实现不了只能自己写绘制逻辑。1.2 三条技术路线怎么选我在做这个项目之前先梳理了社区里主流的三条路线路线思路优点缺点继承DataGridView重写OnPaint在底层绘制阶段覆盖合并区域自由度最大合并区域内容完全可控要处理ClipRectangle、滚动重绘代码量较大订阅CellPainting事件每个单元格触发绘制时动态判断是否处在合并区代码轻量随控件滚动自动处理可见区域每个格子都触发事件量大时略有性能开销第三方扩展组件引入商业或开源合并库开箱即用作者停更风险高样式定制受限多一套依赖三条路我都试过最后项目里用的是“CellPainting为主、OnPaint兜底”的组合方案。原因很简单CellPainting事件天然跟随控件的可视区触发滚动时哪些格子需要重绘、哪些不需要框架已经帮你算好了不用操心裁剪区域代码量少一大截。OnPaint只用来处理一些特殊边框和背景覆盖。2. 合并单元格的核心实现细节2.1 合并区域的描述与数据来源第一步要定义清楚“合并范围”长什么样。我当时定义了一个很轻量的结构体public class MergeRange { public int RowStart { get; set; } public int RowEnd { get; set; } public int ColumnStart { get; set; } public int ColumnEnd { get; set; } public string DisplayText { get; set; } public bool Contains(int row, int col) { return row RowStart row RowEnd col ColumnStart col ColumnEnd; } public bool IsTopLeft(int row, int col) { return row RowStart col ColumnStart; } }合并范围从哪来这个要分场景。表头合并通常是固定的代码里硬编码一个ListMergeRange就行。数据区域合并我在项目里是绑定数据刷新后按照某一列的值自动扫描的相邻行、值相同、且没超出合并上限就归为一个MergeRange。比如产品类别列遍历一遍数据源把相同值的连续行合并成一块。这里有个非常重要的细节合并范围必须在绑定数据后重新计算。我最初踩过坑把合并范围放在构造函数里算结果DataSource一换合并位置全错位了。后来放在DataBindingComplete事件里重新生成合并表这个问题才彻底解决。2.2 用CellPainting绘制合并单元格核心绘制逻辑在CellPainting事件里。思路分三步判断当前正在绘制的单元格是否属于某个合并区域。如果属于且不是合并区域的左上角单元格就把这个格子的默认内容全部“灭掉”只画背景色。如果是左上角单元格就把整个合并区域的可视矩形计算出来一次性画背景、边框和文字。关键代码如下private void dataGridView1_CellPainting(object sender, DataGridViewCellPaintingEventArgs e) { if (e.RowIndex 0 || e.ColumnIndex 0) return; var ranges GetMergedRanges(e.RowIndex, e.ColumnIndex); if (ranges null) return; // 计算合并区域在所有可见状态下的真实矩形 Rectangle mergeRect dataGridView1.GetCellDisplayRectangle(e.ColumnIndex, e.RowIndex, true); for (int r ranges.RowStart; r ranges.RowEnd; r) { for (int c ranges.ColumnStart; c ranges.ColumnEnd; c) { Rectangle cellRect dataGridView1.GetCellDisplayRectangle(c, r, true); mergeRect Rectangle.Union(mergeRect, cellRect); } } // 不是左上角单元格清除默认内容只画纯色背景 if (!ranges.IsTopLeft(e.RowIndex, e.ColumnIndex)) { e.Handled true; using (SolidBrush brush new SolidBrush(dataGridView1.DefaultCellStyle.BackColor)) { e.Graphics.FillRectangle(brush, e.CellBounds); } return; } // 左上角单元格绘制完整合并块 e.Paint(e.CellBounds, DataGridViewPaintParts.Background | DataGridViewPaintParts.Border); using (SolidBrush brush new SolidBrush(mergedBackColor)) { e.Graphics.FillRectangle(brush, mergeRect); } ControlPaint.DrawBorder(e.Graphics, mergeRect, Color.FromArgb(220, 220, 220), ButtonBorderStyle.Solid); TextRenderer.DrawText(e.Graphics, ranges.DisplayText, dataGridView1.Font, mergeRect, foreColor, TextFormatFlags.HorizontalCenter | TextFormatFlags.VerticalCenter); e.Handled true; }这里GetCellDisplayRectangle很重要它会返回指定行、列当前实际显示的位置和大小。滚动时传入true参数返回的是包含滚动偏移量的可视坐标这样才能把多个相邻单元格的实际显示区域拼成一个大矩形。如果不加这个true合并区域会随着滚动出现错位这是最容易踩的坑之一。2.3 处理滚动与ClipRectangle的联动CellPainting方案虽然省去了手动算裁剪区域的麻烦但有一个隐患当合并区域跨多个行、列而滚动导致只有其中一小部分落在可视区时框架会逐个调用可视单元格的CellPainting这时对合并区域的计算要特别小心。我加了一个防御性判断在绘制左上角单元格时先把合并范围与当前ClipRectangle求交集如果交集为空就直接跳过绘制避免浪费性能。这个优化在数据量大、合并区域多的时候特别明显实测大概能减少30%的绘制时间。还有滚动时DataGridView会触发Scroll事件此时如果合并区域没有跟着重绘画面会出现“半截合并块”的残影。我在Scroll事件里加了一行dataGridView1.Invalidate()牺牲一点点性能换视觉完整性这个比值很划算。3. 样式美化的关键配置与列宽问题3.1 列宽“拥挤缩水”的根源热搜里有一条很典型“列标题列宽没有超出却又一些会被拥挤”。这个问题我太熟了十有八九是AutoSizeColumnsMode配置不当引起的。DataGridView的列宽策略分几类None手动控制、DisplayedCells按当前可视单元格内容自动撑宽、Fill填满整个控件宽度、AllCells按所有内容自动撑宽。问题就出在DisplayedCells或AllCells模式下如果所有列自动计算出的宽度总和超过了控件可视宽度DataGridView默认会按比例压缩每一列结果就是明明列宽看起来“没设置”但列标题却被挤成省略号。解法有两个方案一把AutoSizeColumnsMode设为Fill然后通过FillWeight控制各列宽度占比。FillWeight默认是100某一列想宽一点就给大值。方案二给关键列设置MinimumWidth至少保证它不被压缩到过窄。我在项目里用的是组合方案dataGridView1.AutoSizeColumnsMode DataGridViewAutoSizeColumnsMode.Fill; dataGridView1.Columns[ProductName].FillWeight 200; dataGridView1.Columns[ProductName].MinimumWidth 120; dataGridView1.Columns[Qty].FillWeight 50; dataGridView1.Columns[Qty].MinimumWidth 60;这样既能让总宽度自动填满控件又能守住关键列的下限表头就不会再“拥挤得喘不过气”了。3.2 表头样式自定义表头美化是常规操作但有一个隐藏开关经常被忽略EnableHeadersVisualStyles。如果你设置了ColumnHeadersDefaultCellStyle却没生效十有八九是忘了把它设为false。Windows主题样式会默认覆盖自定义表头颜色。完整配置示例dataGridView1.EnableHeadersVisualStyles false; dataGridView1.ColumnHeadersDefaultCellStyle.BackColor Color.FromArgb(52, 73, 94); dataGridView1.ColumnHeadersDefaultCellStyle.ForeColor Color.White; dataGridView1.ColumnHeadersDefaultCellStyle.Font new Font(Microsoft YaHei, 9F, FontStyle.Bold); dataGridView1.ColumnHeadersDefaultCellStyle.Alignment DataGridViewContentAlignment.MiddleCenter; dataGridView1.ColumnHeadersHeightSizeMode DataGridViewColumnHeadersHeightSizeMode.EnableResizing; dataGridView1.ColumnHeadersHeight 36; dataGridView1.ColumnHeadersBorderStyle DataGridViewHeaderBorderStyle.Single; dataGridView1.EnableHeadersVisualStyles false;行头RowHeaders的样式设置同理如果不需要显示行号可以直接RowHeadersVisible false省去不少麻烦。3.3 合并区域的字体与配色设计合并单元格的字体、颜色跟普通单元格不能混用因为它是手动绘制出来的默认样式管不到它。我在绘制方法里单独抽了一个MergedCellStyle类统一管理合并区域的字体、背景色、前景色、对齐方式。颜色方案上表头合并区我用深蓝色底白字数据区合并用浅灰底深灰字这样一眼就能区分两种合并类型。对齐方式统一用水平居中、垂直居中看起来最规整。要注意的是TextRenderer.DrawText跟Graphics.DrawString在字体渲染上有差异前者显示效果更清晰、更贴近Windows原生控件风格我建议用TextRenderer并且传TextFormatFlags.VerticalCenter | TextFormatFlags.HorizontalCenter实现居中。4. 交互体验鼠标悬停与选中高亮4.1 鼠标移到哪一行整行高亮热词里有一条“移动鼠标到某行”对应的需求是把鼠标所在行整行高亮。原生DataGridView没有这个能力需要自己监听MouseMove再结合CellPainting实现。思路在MouseMove里记录当前鼠标所在行号存到字段hoverRowIndex。如果行号变了调用InvalidateRow(旧行)和InvalidateRow(新行)只重绘变化的两行。在CellPainting里判断当前行号是否等于hoverRowIndex如果是且当前行又不是选中行就用淡蓝色画背景。这里要提醒一个性能细节不要用dataGridView1.Invalidate()全量重绘行多的时候会明显卡顿。用InvalidateRow局部刷新用户体验完全不一样。4.2 合并单元格也跟随选中一起高亮“怎么让合并的单元格也一起高亮”是个经典问题。点击合并区域内的非左上角单元格时DataGridView默认只让点击的那个小格子高亮其他部分还是普通底色视觉上特别割裂。我的做法是在SelectionChanged事件里记录当前选中的单元格是否属于某个合并区然后在CellPainting里做判断private void dataGridView1_SelectionChanged(object sender, EventArgs e) { if (dataGridView1.CurrentCell null) return; currentMergeRange FindMergeRange(dataGridView1.CurrentCell.RowIndex, dataGridView1.CurrentCell.ColumnIndex); if (currentMergeRange ! null) { // 只重绘合并区域涉及的单元格减少开销 for (int r currentMergeRange.RowStart; r currentMergeRange.RowEnd; r) { dataGridView1.InvalidateRow(r); } } }然后在CellPainting里如果当前绘制的格子处于currentMergeRange内就把背景色画成选中状态的高亮蓝如果处于其他格子正常绘制。这样合并区域不管点哪个小格子整个区域都会一起亮起来交互体验就跟Excel对齐了。还有一个细节合并区域内的格子点击后仍然可能获得焦点框一个虚线或实线矩形会打破合并块的整体感。我的处理是把这个格子的CurrentCell焦点样式去掉或者在合并区内不允许设置焦点只保留选择状态。5. 常见问题与排查技巧实录5.1 典型问题速查表现象根因解决方案滚动后合并区域文字错位或消失合并区域矩形计算没有包含滚动偏移GetCellDisplayRectangle第二个参数传true合并区域出现黑线或双边框内部单元格的默认边框盖不掉绘制时先FillRectangle覆盖内部区域再DrawBorder画一圈外边框表头样式设置了不生效EnableHeadersVisualStyles仍为true显式设置EnableHeadersVisualStyles false列宽总是被挤压AutoSizeColumnsMode与FillWeight配比不对用Fill模式MinimumWidth兜底点击合并区只高亮一个小格子没有把Selection状态同步到整个合并块在CellPainting中判断合并区并统一绘制高亮背景数据多时滚动卡顿每次滚动全量Invalidate或合并区计算重复太多用InvalidateRow局部刷新并跳过ClipRectangle之外的合并区合并单元格双击弹出编辑框没设置ReadOnly或EditMode不合适合并类单元格所在列设ReadOnly或EditMode设为EditProgrammatically绑定新数据后合并位置全错合并范围没有在绑定完成后重建在DataBindingComplete事件里重新扫描生成合并表5.2 我踩过的几个深坑第一个坑是合并区域绘制时的文本重叠。最开始我直接用e.Graphics.DrawString画文字结果在DPI缩放125%、150%的屏幕上文字位置会偏移跟背景错开半格。后来换成TextRenderer.DrawText并且统一用像素坐标计算居中位置DPI问题基本消失。第二个坑是虚拟模式VirtualMode下合并单元格。如果表格开启虚拟模式单元格内容靠CellValueNeeded事件供给合并区域的计算时机会变得更复杂。我建议在虚拟模式下别做“自动值合并”改为手动指定合并范围控制起来最稳妥。第三个坑是性能。合并区域的CellPainting里我有一个GetMergedRanges方法最初每画一个格子都遍历一次所有合并范围200行10列的数据就有2000次遍历滚动时明显掉帧。后来改成把所有合并范围按行索引建字典画某一行时直接取该行的合并列表性能立刻上去了。5.3 一个实用扩展合并后导出Excel很多项目做完界面显示还不够还要导出到Excel。热词里也出现了“java excel转pdf保留样式”“ureport2 sum如何合并单元格”说明合并需求经常延伸到导出环节。我在这个包里做了个大胆的决定导出Excel时把合并范围信息一并转成Excel的Range对象。使用NPOI或ClosedXML时sheet.MergedCells.AddRange()就能重建合并区域文字内容取MergeRange的DisplayText样式用上面定义的MergedCellStyle映射成Excel单元格样式。这样导出文件的观感和界面上保持一致不会出现界面合并了、导出来却散成一片的尴尬。最后再分享一个小技巧。如果你用的是CellPainting方案绘制完合并区域后一定要把e.Handled true否则DataGridView还会继续执行默认绘制你会看到背景被覆盖了一遍、文字又重画了一遍形成“重影”。另外合并区域的DisplayText建议优先取数据源第一行或第一列的原始值不要自己拼字符串避免出现换行符、空白字符等隐藏问题。这套方案我前后维护了近两年项目从.NET Framework迁移到.NET 6都没动过核心绘制逻辑算是相当稳的实现了。如果你也在做类似的数据表格场景可以直接按这个思路改造遇到具体问题欢迎对照速查表排查。本文还有配套的精品资源点击获取