简介面向WinForm/C#开发者的DataGridView多维合并表头实例包聚焦复杂数据表格场景下表头跨列、跨行合并的实现方案。资源内含可运行的示例项目与配套教程演示HeaderCell样式设置、合并范围计算、绘制逻辑重写及动态数据适配等关键要点适合需要在数据网格中清晰展示层次结构的中级WinForm开发者参考。压缩包共42个文件、约137KB涵盖C#源码、项目工程文件、界面资源、可执行程序以及Word版常见问题说明等类型。其中示例项目DataGridViewSampCs可直接运行调试配套文档梳理了列头合并时的对齐处理、动态刷新注意事项可帮助规避合并后显示错位、数据更新时表头失效等隐患。目前已有2454人浏览学习对增强DataGridView表头表现力、提升复杂界面可读性有直接参考价值。 做WinForm的人十有八九会在DataGridView上遇到“表头要合并”的需求。我做上位机和MES项目时几乎每个报表页都有这种表格最上面一行是“设备信息”下面拆成“设备编号、设备名称、所属车间”中间再来一个“运行参数”下面拆成“温度、压力、转速”。这就是典型的多维合并表头。C#里实现这种事网上答案很零散方法也五花八门很多代码贴出来根本不能用。这篇文章我不讲虚的把我实际用过的方案、踩过的坑、能直接抄的代码都整理出来希望能帮还在跟DataGridView表头死磕的朋友少走弯路。我估摸着看这篇内容的人多半是正在做WinForm项目或者在维护老项目时被要求“把这个报表表头改成合并形式”。不管你是新手还是老手只要项目里用了DataGridView且有这种“大类-小类”“多级标题”的需求下面的内容基本能覆盖你80%的疑问。1. 为什么DataGridView做不了原生多维合并表头刚接触这个问题时我也在VS属性面板里面翻了一圈想着是不是有个ColumnSpan之类的属性可以直接用。结果很遗憾DataGridView从来没有提供过这种跨列合并表头的原生能力。它默认的模型是“一列对应一个表头单元格”表头固定只有一行顶多加一个左上角单元格完全没有多层级的概念。1.1 DataGridView的表头模型其实是“单行线”要理解为什么做不了原生多维合并得先搞清楚DataGridView的表头结构。每个列有一个HeaderCell所有列的表头都挂在同一条水平线上整体高度由ColumnHeadersHeight控制。默认情况下列表头只有一层你只能看到每个列自己的名称没有“分组标题”这种说法。这就是很多人一开始最想不通的地方Excel里面合并单元格那么方便为什么到了DataGridView就什么都没有因为DataGridView的设计目标是灵活展示二维表格数据表头部分只承担“列名”职责。一旦你要在表头上做“几个列共用一个上层标题”就已经超出了它的能力范围必须绕过原生模型。1.2 哪些需求最容易踩进合并表头的坑我整理了一下通常需要合并表头的场景基本集中在下面几类报表展示类常见的“年度汇总”下面分“一季度、二季度、三季度、四季度”每季度下面再分“计划、实际”这就是两层甚至三层结构。上位机监控界面设备管理里常有“设备状态”大分组下面再分“开关量1、开关量2、模拟量1、模拟量2”还经常搭配实时刷新。ERP/MES业务页面物料清单、订单明细经常要求“基础信息”列组和“贸易条款”列组并排。导入Excel前的预览把Excel表格结构映射到DataGridView预览表头往往要完全复刻Excel样式。这些场景的共同特点是列多、分组固定、同时表头还要跟数据一起滚动。如果你用第三方的Grid控制比如DevExpress或者ComponentOne可能还自带合并表头功能。但项目里如果已经定了要用原生DataGridView那只能用下面说的几个路子去“模拟”出合并效果。2. 方案选型三种主流合并表头做法实测网上关于DataGridView合并表头的方案扒掉各种花里胡哨的包装后真正能用在生产环境里的就三种。我分别说说它们的原理、优缺点以及我在项目里的真实体验。2.1 方案ACellPainting自绘表头自绘是目前我用得最多的方案思路是把DataGridView的列头高度调高然后拦截表头绘制事件自己画分组矩形和分组文字。核心代码入口是CellPainting事件。当e.RowIndex -1时表示当前绘制的是列头区域。你可以在这个事件里完全接管绘制逻辑用GDI把“上层分组标题”画出来再用e.PaintBackground和TextRenderer.DrawText画每个小列的名称。这个方案的好处是自由度最高两层三层都能控制不需要额外控件。缺点是计算比较绕尤其是列宽变化、水平滚动、DPI缩放时矩形坐标容易算错。新手第一次做踩坑概率不低。2.2 方案B用Label或Panel覆盖在表头区第二种方案是用一堆Label或Panel手动摆在列头上方模拟出“合并分组”的视觉效果。做法是把DataGridView的ColumnHeadersHeight调大然后在表头区域放一个Panel再往Panel里塞Label每个Label的宽度等于一组合并列的总宽度。这个方案实现非常快很多临时演示项目里我都这么干。但它有个致命问题DataGridView一旦发生滚动、列宽调整、窗体缩放Label不会自动跟着变位置你必须自己监听Scroll、ColumnWidthChanged、Resize等事件然后把Label重新排版。列一多维护成本会爆炸。2.3 方案C双层DataGridView拼合还有一种骚操作是用两个DataGridView上下堆叠上面那个只显示表头下面那个显示数据。上面表格去掉边框、禁用滚动和编辑专门用来展示合并表头下面表格正常绑定数据。两个表格需要同步滚动条并且在列宽变化时手动同步列宽度。这个方案的视觉效果最接近“真正合并表头”但因为有两套控件代码量反而更大。而且一旦涉及单元格编辑、行高变化、冻结列各种对齐问题能让人抓狂。我不太推荐在复杂项目里用除非你的需求极其固定且不允许改。三种方案我简单做了个对比方便快速选型方案实现成本扩展性性能坑的严重程度CellPainting自绘中高高可多层扩展高中等矩形计算需仔细Label/Panel覆盖低低列变化维护麻烦中滚动/缩放时容易错位双层DataGridView拼合高低对齐困难中高控件联动复杂3. 从零到一实现可复用的两层级合并表头下面我以最常用的两层合并表头为例手把手把自绘方案实现一遍。这个方案我实测过很多次代码逻辑清晰适合作为项目里的通用基础版。我们先做一个简单的“大分组子列”结构。3.1 先设置DataGridView表头高度与基础属性自绘之前设计期属性需要先铺好。我习惯于在窗体构造函数里做初始化这样后面维护时一眼能看到关键设置。public Form1() { InitializeComponent(); // 关闭系统默认表头样式否则会盖住自绘内容 dgv.EnableHeadersVisualStyles false; // 表头高度手动设置留出两层标题的空间 dgv.ColumnHeadersHeightSizeMode DataGridViewColumnHeadersHeightSizeMode.Disable; dgv.ColumnHeadersHeight 60; // 避免用户拖动列宽导致自绘矩形错乱 dgv.AllowUserToResizeColumns false; dgv.AllowUserToResizeRows false; // 水平滚动条看情况保留但需要配套处理滚动后重绘 dgv.Scroll (s, e) dgv.Invalidate(); // 挂上绘制事件 dgv.CellPainting Dgv_CellPainting; }这里有一个重要细节EnableHeadersVisualStyles false必须设置为false否则系统会根据主题自动绘制ColumnHeader背景把我们自己的绘制内容覆盖掉。ColumnHeadersHeightSizeMode也必须禁用自动高度因为我们主动把表头高度拉到60像素就是为了把上层的分组标题和下层的列名分区。3.2 用CellPainting把分组线画出来接下来是核心绘制逻辑。我在项目里的做法是这样先建立一个列和分组的关系映射比如用一个int[]数组数组下标是列索引值是分组编号再用一个string[]数组保存分组名称。绘制时如果发现当前列是某个分组的起始列就从起始列一直画到结束列形成一个大矩形矩形内写分组名称。private void Dgv_CellPainting(object sender, DataGridViewCellPaintingEventArgs e) { // 只在列头区域处理 if (e.RowIndex ! -1 || e.ColumnIndex 0) { return; } // 分组映射列索引 - 所属分组编号 int[] groupIdOfCol { 0, 0, 0, 1, 1, 2, 2, 2 }; string[] groupNames { 基础信息, 订单数据, 汇总统计 }; int col e.ColumnIndex; int currentGroup groupIdOfCol[col]; // 先绘制默认背景保留原生的单元格底色 e.PaintBackground(e.ClipBounds, true); // 查找当前分组的起始列和结束列 int startCol col; while (startCol 0 groupIdOfCol[startCol - 1] currentGroup) { startCol--; } int endCol col; while (endCol dgv.Columns.Count - 1 groupIdOfCol[endCol 1] currentGroup) { endCol; } // 上半部分的高度 int topHeight dgv.ColumnHeadersHeight / 2; // 只有当前列是分组起始列时才负责绘制整组的大标题 if (col startCol) { Rectangle groupRect new Rectangle( dgv.GetCellDisplayRectangle(startCol, -1, true).Left, dgv.GetCellDisplayRectangle(startCol, -1, true).Top, dgv.GetCellDisplayRectangle(endCol, -1, true).Right - dgv.GetCellDisplayRectangle(startCol, -1, true).Left, topHeight); using (SolidBrush brush new SolidBrush(Color.FromArgb(220, 220, 220))) { e.Graphics.FillRectangle(brush, groupRect); } TextRenderer.DrawText( e.Graphics, groupNames[currentGroup], dgv.Font, groupRect, Color.Black, TextFormatFlags.HorizontalCenter | TextFormatFlags.VerticalCenter); e.Graphics.DrawRectangle(Pens.DarkGray, groupRect); } else { // 非起始列也要把上半部分背景补齐否则会露出空白 Rectangle topRect new Rectangle( dgv.GetCellDisplayRectangle(col, -1, true).Left, dgv.GetCellDisplayRectangle(col, -1, true).Top, dgv.GetCellDisplayRectangle(col, -1, true).Width, topHeight); using (SolidBrush brush new SolidBrush(Color.FromArgb(220, 220, 220))) { e.Graphics.FillRectangle(brush, topRect); } e.Graphics.DrawRectangle(Pens.DarkGray, topRect); } // 下半部分绘制每个小列的列名和边框 Rectangle subRect new Rectangle( e.CellBounds.Left, e.CellBounds.Top topHeight, e.CellBounds.Width, dgv.ColumnHeadersHeight - topHeight); TextRenderer.DrawText( e.Graphics, dgv.Columns[col].HeaderText, dgv.Font, subRect, Color.Black, TextFormatFlags.HorizontalCenter | TextFormatFlags.VerticalCenter); e.Graphics.DrawRectangle(Pens.DarkGray, subRect); // 关键是标记已处理阻止系统再画默认表头 e.Handled true; }这段代码看起来唬人其实核心逻辑只有三步。第一步根据映射找到当前列所属分组的起始点和结束点比如三列属于“基础信息”那分组矩形就要横跨这三列。第二步在第一列的位置绘制分组标题其他列只负责补背景色和边框避免被系统默认覆盖。第三步在下半区绘制各列自带的HeaderText这就是我们平时看到的列名。3.3 处理滚动和列宽调整的联动问题如果你的表格没有水平滚动、也不允许用户拖列宽上面的代码基本够用。但实际项目中列一多通常需要滚动。DataGridView的水平滚动条滚动时表头单元格也会跟着移动怎么保证分组矩形不歪我的办法很简单在Scroll事件里调用dgv.Invalidate()强制表头区域重新绘制。因为每次滚动相关列头都会重新触发CellPainting绘制代码会基于GetCellDisplayRectangle重新计算坐标所以只要重绘逻辑本身是动态算的滚动后自然就对齐了。这里最容易踩的坑是很多人把分组起始列的索引或坐标缓存下来第一次画对了滚动后就全乱套。所以记住绘制逻辑里永远不要缓存坐标每次动态计算。列宽调整同理。如果实在需要用户拖列宽在ColumnWidthChanged事件里也调用一次Invalidate。不过我个人建议在合并表头的场景下直接把AllowUserToResizeColumns关掉交互上更安全。4. 从两层级扩展到三层、四层合并表头很多小伙伴以为两层合并就是终点实际业务里三层表头也很常见比如“销售数据”-“2024年度”-“第一季度/第二季度”。自绘方案扩展到三层并不算复杂但需要把“分组映射”升级成“层级模型”。4.1 用一个表头模型表来管理层级我的做法是定义一棵“表头树”。树的每个节点包含节点名称、层级、子节点列表、以及对应的列索引范围。绘制的时候从根节点开始递归按层级从上到下逐层分割表头矩形。简单示意public class HeaderNode { public string Name { get; set; } public ListHeaderNode Children { get; set; } new ListHeaderNode(); public int GroupLevel { get; set; } public int StartCol { get; set; } public int EndCol { get; set; } }构建好树之后再配合递归函数根据节点占用的列范围计算矩形。绘制顺序是从最上层开始每层占用的高度等于ColumnHeadersHeight / 总层级数。这样不管你是两层、三层还是四层只要把树建好绘制逻辑都不需要大改。这比在事件里写死多个groupIdOfCol数组要健壮得多。项目后期要新增一个分组我只需要改树上挂的节点不用动绘制代码。如果绑定的是DataTable还可以根据DataColumn动态生成表头树实现“动态列合并表头”的效果。4.2 自适应列宽与动态列绑定动态列的场景要额外注意一点列集合是在运行时才确定的比如查询数据库返回了哪些字段程序再动态添加列。这时候groupIdOfCol这种数组没法在构造函数里初始化必须在列创建完成后再重建。我的习惯是专门写一个RebuildHeaderTree(DataTable dt)方法把DataTable的列名映射到HeaderNode上。这样处理有几个好处第一前端展示时列宽可以按内容自动调整表头依然对齐第二后续报表需求变化只需要改DataTable结构界面代码不用动第三分组逻辑和数据源解耦方便单元测试。实际项目中我做过一个三层动态表头左边是“点位明细”中间是“实时数据”右边是“统计数据”数据源每天换列名也每天变全靠这套模型撑住。如果当初用固定数组写死早就改到崩溃了。5. 高频踩坑排查表与性能优化建议不管方案选哪个最后一定会在细节上出问题。这部分我整理了这几年在合并表头实战中遇到过的典型坑按“问题现象 - 原因 - 解决办法”的形式列出来方便你直接对照排查。5.1 常见问题速查表问题现象根本原因解决办法自绘的表头文字和分组线被系统默认样式覆盖没有设置EnableHeadersVisualStyles false在设计器或代码里显式把它设为false表头分组大标题显示不完整或者没显示分组起始列判断错误或者GetCellDisplayRectangle传入的参数不对确认groupIdOfCol映射正确起始列条件用col startCol横向滚动后分组标题错位、重叠滚动时没触发重绘或者绘制代码里缓存了坐标监听Scroll事件调用Invalidate()所有坐标动态计算列宽调整后分组线歪了列宽变化没有同步刷新表头区域监听ColumnWidthChanged事件同样调用Invalidate()表头区域双缓冲后还是闪烁严重DataGridView本身默认双缓冲不完善绘制又太复杂开启单例双缓冲可反射设置DoubleBuffered true文字模糊尤其是高DPI显示器WinForm没有自动处理DPI缩放绘制坐标用了绝对像素启动时调用DPI感知或根据DeviceDpi缩放表头高度和字体点击列头排序时合并出的顶部大标题消失排序触发表头重绘绘制逻辑被默认排序箭头覆盖在绘制事件里重新填充顶部背景并理解排序箭头的绘制占用这里面我想单独强调一下DPI问题。现在高分屏越来越多很多人做出来的合并表头在自己电脑上正常一到客户那边整台机器都是糊的。最常见原因就是直接用ColumnHeadersHeight 60这种固定值没有按DPI做比例换算。最简单的做法是在窗体加载时读取this.DeviceDpi然后乘以一个系数去设置表头高度。字体也建议用dgv.Font不要另建绝对大小的Font。5.2 给新手的一个稳定起步配置如果你不想一上来就啃上面那套绘制逻辑我建议从最小可用版本开始。先不做动态列不做三层就做一个两层合并表头所有列和数据源都是静态的。把EnableHeadersVisualStylesfalse、表头高度设置好然后复制我上面那段CellPainting代码改一改groupIdOfCol和groupNames基本就能跑起来。等跑通了一个静态版本再逐步引入动态列、滚动联动、DPI适配。这样每步都可验证排查起来也快。上来就写一个全功能版一旦出问题根本不知道是映射错了还是坐标歪了非常折磨。我个人在实际项目中的体会是能用原生数据控件解决就不用第三方能自绘就不要叠加控件能静态映射就不要上树模型。DataGridView合并表头说到底就是一个“从列模型到坐标模型”的转换问题你把映射关系想清楚后面所有细节都只是绘制技巧。最后再分享一个小技巧写完记得反射开一下DoubleBuffered不然表头刷新时闪烁感会很明显尤其在你上了滚动联动之后效果立竿见影。本文还有配套的精品资源点击获取 WinForm DataGridView 合并表头实战：从自绘到三层扩展
简介面向WinForm/C#开发者的DataGridView多维合并表头实例包聚焦复杂数据表格场景下表头跨列、跨行合并的实现方案。资源内含可运行的示例项目与配套教程演示HeaderCell样式设置、合并范围计算、绘制逻辑重写及动态数据适配等关键要点适合需要在数据网格中清晰展示层次结构的中级WinForm开发者参考。压缩包共42个文件、约137KB涵盖C#源码、项目工程文件、界面资源、可执行程序以及Word版常见问题说明等类型。其中示例项目DataGridViewSampCs可直接运行调试配套文档梳理了列头合并时的对齐处理、动态刷新注意事项可帮助规避合并后显示错位、数据更新时表头失效等隐患。目前已有2454人浏览学习对增强DataGridView表头表现力、提升复杂界面可读性有直接参考价值。 做WinForm的人十有八九会在DataGridView上遇到“表头要合并”的需求。我做上位机和MES项目时几乎每个报表页都有这种表格最上面一行是“设备信息”下面拆成“设备编号、设备名称、所属车间”中间再来一个“运行参数”下面拆成“温度、压力、转速”。这就是典型的多维合并表头。C#里实现这种事网上答案很零散方法也五花八门很多代码贴出来根本不能用。这篇文章我不讲虚的把我实际用过的方案、踩过的坑、能直接抄的代码都整理出来希望能帮还在跟DataGridView表头死磕的朋友少走弯路。我估摸着看这篇内容的人多半是正在做WinForm项目或者在维护老项目时被要求“把这个报表表头改成合并形式”。不管你是新手还是老手只要项目里用了DataGridView且有这种“大类-小类”“多级标题”的需求下面的内容基本能覆盖你80%的疑问。1. 为什么DataGridView做不了原生多维合并表头刚接触这个问题时我也在VS属性面板里面翻了一圈想着是不是有个ColumnSpan之类的属性可以直接用。结果很遗憾DataGridView从来没有提供过这种跨列合并表头的原生能力。它默认的模型是“一列对应一个表头单元格”表头固定只有一行顶多加一个左上角单元格完全没有多层级的概念。1.1 DataGridView的表头模型其实是“单行线”要理解为什么做不了原生多维合并得先搞清楚DataGridView的表头结构。每个列有一个HeaderCell所有列的表头都挂在同一条水平线上整体高度由ColumnHeadersHeight控制。默认情况下列表头只有一层你只能看到每个列自己的名称没有“分组标题”这种说法。这就是很多人一开始最想不通的地方Excel里面合并单元格那么方便为什么到了DataGridView就什么都没有因为DataGridView的设计目标是灵活展示二维表格数据表头部分只承担“列名”职责。一旦你要在表头上做“几个列共用一个上层标题”就已经超出了它的能力范围必须绕过原生模型。1.2 哪些需求最容易踩进合并表头的坑我整理了一下通常需要合并表头的场景基本集中在下面几类报表展示类常见的“年度汇总”下面分“一季度、二季度、三季度、四季度”每季度下面再分“计划、实际”这就是两层甚至三层结构。上位机监控界面设备管理里常有“设备状态”大分组下面再分“开关量1、开关量2、模拟量1、模拟量2”还经常搭配实时刷新。ERP/MES业务页面物料清单、订单明细经常要求“基础信息”列组和“贸易条款”列组并排。导入Excel前的预览把Excel表格结构映射到DataGridView预览表头往往要完全复刻Excel样式。这些场景的共同特点是列多、分组固定、同时表头还要跟数据一起滚动。如果你用第三方的Grid控制比如DevExpress或者ComponentOne可能还自带合并表头功能。但项目里如果已经定了要用原生DataGridView那只能用下面说的几个路子去“模拟”出合并效果。2. 方案选型三种主流合并表头做法实测网上关于DataGridView合并表头的方案扒掉各种花里胡哨的包装后真正能用在生产环境里的就三种。我分别说说它们的原理、优缺点以及我在项目里的真实体验。2.1 方案ACellPainting自绘表头自绘是目前我用得最多的方案思路是把DataGridView的列头高度调高然后拦截表头绘制事件自己画分组矩形和分组文字。核心代码入口是CellPainting事件。当e.RowIndex -1时表示当前绘制的是列头区域。你可以在这个事件里完全接管绘制逻辑用GDI把“上层分组标题”画出来再用e.PaintBackground和TextRenderer.DrawText画每个小列的名称。这个方案的好处是自由度最高两层三层都能控制不需要额外控件。缺点是计算比较绕尤其是列宽变化、水平滚动、DPI缩放时矩形坐标容易算错。新手第一次做踩坑概率不低。2.2 方案B用Label或Panel覆盖在表头区第二种方案是用一堆Label或Panel手动摆在列头上方模拟出“合并分组”的视觉效果。做法是把DataGridView的ColumnHeadersHeight调大然后在表头区域放一个Panel再往Panel里塞Label每个Label的宽度等于一组合并列的总宽度。这个方案实现非常快很多临时演示项目里我都这么干。但它有个致命问题DataGridView一旦发生滚动、列宽调整、窗体缩放Label不会自动跟着变位置你必须自己监听Scroll、ColumnWidthChanged、Resize等事件然后把Label重新排版。列一多维护成本会爆炸。2.3 方案C双层DataGridView拼合还有一种骚操作是用两个DataGridView上下堆叠上面那个只显示表头下面那个显示数据。上面表格去掉边框、禁用滚动和编辑专门用来展示合并表头下面表格正常绑定数据。两个表格需要同步滚动条并且在列宽变化时手动同步列宽度。这个方案的视觉效果最接近“真正合并表头”但因为有两套控件代码量反而更大。而且一旦涉及单元格编辑、行高变化、冻结列各种对齐问题能让人抓狂。我不太推荐在复杂项目里用除非你的需求极其固定且不允许改。三种方案我简单做了个对比方便快速选型方案实现成本扩展性性能坑的严重程度CellPainting自绘中高高可多层扩展高中等矩形计算需仔细Label/Panel覆盖低低列变化维护麻烦中滚动/缩放时容易错位双层DataGridView拼合高低对齐困难中高控件联动复杂3. 从零到一实现可复用的两层级合并表头下面我以最常用的两层合并表头为例手把手把自绘方案实现一遍。这个方案我实测过很多次代码逻辑清晰适合作为项目里的通用基础版。我们先做一个简单的“大分组子列”结构。3.1 先设置DataGridView表头高度与基础属性自绘之前设计期属性需要先铺好。我习惯于在窗体构造函数里做初始化这样后面维护时一眼能看到关键设置。public Form1() { InitializeComponent(); // 关闭系统默认表头样式否则会盖住自绘内容 dgv.EnableHeadersVisualStyles false; // 表头高度手动设置留出两层标题的空间 dgv.ColumnHeadersHeightSizeMode DataGridViewColumnHeadersHeightSizeMode.Disable; dgv.ColumnHeadersHeight 60; // 避免用户拖动列宽导致自绘矩形错乱 dgv.AllowUserToResizeColumns false; dgv.AllowUserToResizeRows false; // 水平滚动条看情况保留但需要配套处理滚动后重绘 dgv.Scroll (s, e) dgv.Invalidate(); // 挂上绘制事件 dgv.CellPainting Dgv_CellPainting; }这里有一个重要细节EnableHeadersVisualStyles false必须设置为false否则系统会根据主题自动绘制ColumnHeader背景把我们自己的绘制内容覆盖掉。ColumnHeadersHeightSizeMode也必须禁用自动高度因为我们主动把表头高度拉到60像素就是为了把上层的分组标题和下层的列名分区。3.2 用CellPainting把分组线画出来接下来是核心绘制逻辑。我在项目里的做法是这样先建立一个列和分组的关系映射比如用一个int[]数组数组下标是列索引值是分组编号再用一个string[]数组保存分组名称。绘制时如果发现当前列是某个分组的起始列就从起始列一直画到结束列形成一个大矩形矩形内写分组名称。private void Dgv_CellPainting(object sender, DataGridViewCellPaintingEventArgs e) { // 只在列头区域处理 if (e.RowIndex ! -1 || e.ColumnIndex 0) { return; } // 分组映射列索引 - 所属分组编号 int[] groupIdOfCol { 0, 0, 0, 1, 1, 2, 2, 2 }; string[] groupNames { 基础信息, 订单数据, 汇总统计 }; int col e.ColumnIndex; int currentGroup groupIdOfCol[col]; // 先绘制默认背景保留原生的单元格底色 e.PaintBackground(e.ClipBounds, true); // 查找当前分组的起始列和结束列 int startCol col; while (startCol 0 groupIdOfCol[startCol - 1] currentGroup) { startCol--; } int endCol col; while (endCol dgv.Columns.Count - 1 groupIdOfCol[endCol 1] currentGroup) { endCol; } // 上半部分的高度 int topHeight dgv.ColumnHeadersHeight / 2; // 只有当前列是分组起始列时才负责绘制整组的大标题 if (col startCol) { Rectangle groupRect new Rectangle( dgv.GetCellDisplayRectangle(startCol, -1, true).Left, dgv.GetCellDisplayRectangle(startCol, -1, true).Top, dgv.GetCellDisplayRectangle(endCol, -1, true).Right - dgv.GetCellDisplayRectangle(startCol, -1, true).Left, topHeight); using (SolidBrush brush new SolidBrush(Color.FromArgb(220, 220, 220))) { e.Graphics.FillRectangle(brush, groupRect); } TextRenderer.DrawText( e.Graphics, groupNames[currentGroup], dgv.Font, groupRect, Color.Black, TextFormatFlags.HorizontalCenter | TextFormatFlags.VerticalCenter); e.Graphics.DrawRectangle(Pens.DarkGray, groupRect); } else { // 非起始列也要把上半部分背景补齐否则会露出空白 Rectangle topRect new Rectangle( dgv.GetCellDisplayRectangle(col, -1, true).Left, dgv.GetCellDisplayRectangle(col, -1, true).Top, dgv.GetCellDisplayRectangle(col, -1, true).Width, topHeight); using (SolidBrush brush new SolidBrush(Color.FromArgb(220, 220, 220))) { e.Graphics.FillRectangle(brush, topRect); } e.Graphics.DrawRectangle(Pens.DarkGray, topRect); } // 下半部分绘制每个小列的列名和边框 Rectangle subRect new Rectangle( e.CellBounds.Left, e.CellBounds.Top topHeight, e.CellBounds.Width, dgv.ColumnHeadersHeight - topHeight); TextRenderer.DrawText( e.Graphics, dgv.Columns[col].HeaderText, dgv.Font, subRect, Color.Black, TextFormatFlags.HorizontalCenter | TextFormatFlags.VerticalCenter); e.Graphics.DrawRectangle(Pens.DarkGray, subRect); // 关键是标记已处理阻止系统再画默认表头 e.Handled true; }这段代码看起来唬人其实核心逻辑只有三步。第一步根据映射找到当前列所属分组的起始点和结束点比如三列属于“基础信息”那分组矩形就要横跨这三列。第二步在第一列的位置绘制分组标题其他列只负责补背景色和边框避免被系统默认覆盖。第三步在下半区绘制各列自带的HeaderText这就是我们平时看到的列名。3.3 处理滚动和列宽调整的联动问题如果你的表格没有水平滚动、也不允许用户拖列宽上面的代码基本够用。但实际项目中列一多通常需要滚动。DataGridView的水平滚动条滚动时表头单元格也会跟着移动怎么保证分组矩形不歪我的办法很简单在Scroll事件里调用dgv.Invalidate()强制表头区域重新绘制。因为每次滚动相关列头都会重新触发CellPainting绘制代码会基于GetCellDisplayRectangle重新计算坐标所以只要重绘逻辑本身是动态算的滚动后自然就对齐了。这里最容易踩的坑是很多人把分组起始列的索引或坐标缓存下来第一次画对了滚动后就全乱套。所以记住绘制逻辑里永远不要缓存坐标每次动态计算。列宽调整同理。如果实在需要用户拖列宽在ColumnWidthChanged事件里也调用一次Invalidate。不过我个人建议在合并表头的场景下直接把AllowUserToResizeColumns关掉交互上更安全。4. 从两层级扩展到三层、四层合并表头很多小伙伴以为两层合并就是终点实际业务里三层表头也很常见比如“销售数据”-“2024年度”-“第一季度/第二季度”。自绘方案扩展到三层并不算复杂但需要把“分组映射”升级成“层级模型”。4.1 用一个表头模型表来管理层级我的做法是定义一棵“表头树”。树的每个节点包含节点名称、层级、子节点列表、以及对应的列索引范围。绘制的时候从根节点开始递归按层级从上到下逐层分割表头矩形。简单示意public class HeaderNode { public string Name { get; set; } public ListHeaderNode Children { get; set; } new ListHeaderNode(); public int GroupLevel { get; set; } public int StartCol { get; set; } public int EndCol { get; set; } }构建好树之后再配合递归函数根据节点占用的列范围计算矩形。绘制顺序是从最上层开始每层占用的高度等于ColumnHeadersHeight / 总层级数。这样不管你是两层、三层还是四层只要把树建好绘制逻辑都不需要大改。这比在事件里写死多个groupIdOfCol数组要健壮得多。项目后期要新增一个分组我只需要改树上挂的节点不用动绘制代码。如果绑定的是DataTable还可以根据DataColumn动态生成表头树实现“动态列合并表头”的效果。4.2 自适应列宽与动态列绑定动态列的场景要额外注意一点列集合是在运行时才确定的比如查询数据库返回了哪些字段程序再动态添加列。这时候groupIdOfCol这种数组没法在构造函数里初始化必须在列创建完成后再重建。我的习惯是专门写一个RebuildHeaderTree(DataTable dt)方法把DataTable的列名映射到HeaderNode上。这样处理有几个好处第一前端展示时列宽可以按内容自动调整表头依然对齐第二后续报表需求变化只需要改DataTable结构界面代码不用动第三分组逻辑和数据源解耦方便单元测试。实际项目中我做过一个三层动态表头左边是“点位明细”中间是“实时数据”右边是“统计数据”数据源每天换列名也每天变全靠这套模型撑住。如果当初用固定数组写死早就改到崩溃了。5. 高频踩坑排查表与性能优化建议不管方案选哪个最后一定会在细节上出问题。这部分我整理了这几年在合并表头实战中遇到过的典型坑按“问题现象 - 原因 - 解决办法”的形式列出来方便你直接对照排查。5.1 常见问题速查表问题现象根本原因解决办法自绘的表头文字和分组线被系统默认样式覆盖没有设置EnableHeadersVisualStyles false在设计器或代码里显式把它设为false表头分组大标题显示不完整或者没显示分组起始列判断错误或者GetCellDisplayRectangle传入的参数不对确认groupIdOfCol映射正确起始列条件用col startCol横向滚动后分组标题错位、重叠滚动时没触发重绘或者绘制代码里缓存了坐标监听Scroll事件调用Invalidate()所有坐标动态计算列宽调整后分组线歪了列宽变化没有同步刷新表头区域监听ColumnWidthChanged事件同样调用Invalidate()表头区域双缓冲后还是闪烁严重DataGridView本身默认双缓冲不完善绘制又太复杂开启单例双缓冲可反射设置DoubleBuffered true文字模糊尤其是高DPI显示器WinForm没有自动处理DPI缩放绘制坐标用了绝对像素启动时调用DPI感知或根据DeviceDpi缩放表头高度和字体点击列头排序时合并出的顶部大标题消失排序触发表头重绘绘制逻辑被默认排序箭头覆盖在绘制事件里重新填充顶部背景并理解排序箭头的绘制占用这里面我想单独强调一下DPI问题。现在高分屏越来越多很多人做出来的合并表头在自己电脑上正常一到客户那边整台机器都是糊的。最常见原因就是直接用ColumnHeadersHeight 60这种固定值没有按DPI做比例换算。最简单的做法是在窗体加载时读取this.DeviceDpi然后乘以一个系数去设置表头高度。字体也建议用dgv.Font不要另建绝对大小的Font。5.2 给新手的一个稳定起步配置如果你不想一上来就啃上面那套绘制逻辑我建议从最小可用版本开始。先不做动态列不做三层就做一个两层合并表头所有列和数据源都是静态的。把EnableHeadersVisualStylesfalse、表头高度设置好然后复制我上面那段CellPainting代码改一改groupIdOfCol和groupNames基本就能跑起来。等跑通了一个静态版本再逐步引入动态列、滚动联动、DPI适配。这样每步都可验证排查起来也快。上来就写一个全功能版一旦出问题根本不知道是映射错了还是坐标歪了非常折磨。我个人在实际项目中的体会是能用原生数据控件解决就不用第三方能自绘就不要叠加控件能静态映射就不要上树模型。DataGridView合并表头说到底就是一个“从列模型到坐标模型”的转换问题你把映射关系想清楚后面所有细节都只是绘制技巧。最后再分享一个小技巧写完记得反射开一下DoubleBuffered不然表头刷新时闪烁感会很明显尤其在你上了滚动联动之后效果立竿见影。本文还有配套的精品资源点击获取