简介：面向C# WinForms开发者的实用教程资源，聚焦DataGridView控件本身不支持树形结构这一痛点，讲解如何通过自定义数据模型、扩展控件功能与事件处理，在表格中模拟出层次化数据的展开与折叠效果，适合已具备一定WinForms基础、希望提升控件定制能力的中级开发者参考。压缩包共32个文件，约68KB，以cs源码文件为主，辅以config配置、resx资源、csproj项目文件及编译生成的exe、pdb等，完整保留了grid_test示例工程，可直接在Visual Studio中打开调试。已有1959人学习下载。读者可通过源码理解树节点模型设计、CellClick事件驱动的展开折叠逻辑、列显示隐藏控制以及OnRowPrePaint自定义绘制展开图标等关键实现，并借助示例工程对照调试，掌握DataGridView在层次化数据展示场景下的扩展思路与排错方法。

1. 需求先立住：为什么非要在 DataGridView 里塞一棵树

做桌面端管理系统的同行大概都遇到过这种需求：一张表格要同时表达层级关系和明细字段。典型场景是组织架构、物料 BOM、科目树、菜单权限，用户既想看到父子缩进，又想在每一行上直接编辑编码、名称、数量这些列。用 TreeView 吧，只能显示一列文本，想加个数量列就得自己画；用 DataGridView 吧，它天生是平铺的，没有层级概念。于是「DataGridView 树形列表」这个组合就成了搜索高频词，也是不少毕设和课程设计里绕不开的一个模块。

这套方案要解决的就是这件事：在不引入第三方控件的前提下，用标准 DataGridView 呈现一棵可展开、可折叠、可编辑、可勾选的树，并且把数据加载、节点标识、状态保持这几件事做扎实。适合两类人：正在做管理系统类毕设、需要交一个能演示层级表格的学生；以及要在既有 WinForms 项目里补一个树形列表、又不想引商业控件的从业者。下面按需求、设计、实现、避坑、验收的顺序走一遍，能直接照着改。

2. 总体设计：一张平表 + 三个关键机制

2.1 用「扁平化 + 缩进」代替真正的树控件

核心思路一句话：数据在内存里是树，落到 DataGridView 上是按先序遍历展开的平表，层级感靠单元格缩进和展开符号模拟。这样做的最大好处是复用了 DataGridView 的全部能力——列类型、编辑、排序、右键菜单、导出，全都不用重写。代价是每次展开/折叠都要重算可见行集合，这个代价在几千节点量级完全可接受。

数据结构上，每个节点至少要有这几个字段：唯一标识 Id、父标识 ParentId、显示文本 Name、层级 Level、是否有子节点 HasChildren、展开状态 IsExpanded。Level 不是存死的，而是加载时按父子关系算出来的，避免数据源里维护冗余字段导致不一致。HasChildren 同理，可以由子集合是否为空推导，但为了渲染时少一次遍历，通常在构建树时顺手写回。

public class TreeNodeItem { public string Id { get; set; } // 节点唯一标识，建议用业务主键而非自增序号 public string ParentId { get; set; } // 根节点为 null 或空串 public string Name { get; set; } // 显示文本 public int Level { get; set; } // 层级，0 为根 public bool HasChildren { get; set; } // 是否有子节点，构建时写回 public bool IsExpanded { get; set; } // 展开状态，折叠时保留 public List<TreeNodeItem> Children { get; set; } = new List<TreeNodeItem>(); }

这段模型是整个方案的地基。Id 用业务主键而不是自增序号，是因为展开状态、勾选状态都要按 Id 记忆，序号在重新加载后会漂移。Children 集合保留在内存里，是为了折叠后还能快速恢复，不用回数据库再查一次。

2.2 可见行集合的维护策略

界面上显示哪些行，取决于每个节点的「祖先链是否全部展开」。最直接的做法是每次状态变化后从根重新做一次先序遍历，把满足条件的节点收集成一个 List，再整体赋给 DataSource。节点上万时这个全量重算会有卡顿，通常的做法是只重算受影响子树：折叠某节点时，把它所有后代从可见集合里移除；展开时，把它的直接子节点按序插回。两种策略我都写过，节点数在两千以内用全量重算最省心，超过这个量级再上增量。

// 全量重算可见行，简单可靠，适合中小数据量 private List<TreeNodeItem> BuildVisibleRows(List<TreeNodeItem> roots) { var result = new List<TreeNodeItem>(); void Walk(TreeNodeItem node) { result.Add(node); // 先序：先自己 if (!node.IsExpanded) return; // 折叠则不深入子节点 foreach (var child in node.Children) Walk(child); } foreach (var root in roots) Walk(root); return result; }

递归里那个if (!node.IsExpanded) return;就是折叠的全部逻辑——不展开就不往下走，后代自然不进可见集合。参数上唯一要注意的是 roots 的顺序，业务上一般按排序字段排好再传进来，别指望 DataGridView 自己排，因为它排的是平表，会把父子顺序打乱。

2.3 展开符号与缩进的绘制位置

缩进和加减号不能靠改单元格值实现，否则编辑时会把符号一起改掉。正确做法是处理 CellPainting 事件，在单元格内容左侧画符号和缩进，同时把单元格的 Padding 调开，给绘制留位置。符号用文本「+」「-」画最省事，也可以用 Graphics 画矩形和线段，前者跨 DPI 更稳。

private void grid_CellPainting(object sender, DataGridViewCellPaintingEventArgs e) { if (e.RowIndex < 0 || e.ColumnIndex != 0) return; // 只在首列画 var node = (TreeNodeItem)grid.Rows[e.RowIndex].DataBoundItem; e.PaintBackground(e.CellBounds, true); int indent = node.Level * 16; // 每级缩进 16 像素 var symbolRect = new Rectangle(e.CellBounds.X + indent, e.CellBounds.Y, 16, e.CellBounds.Height); if (node.HasChildren) TextRenderer.DrawText(e.Graphics, node.IsExpanded ? "-" : "+", grid.Font, symbolRect, Color.DimGray, TextFormatFlags.VerticalCenter); var textRect = new Rectangle(symbolRect.Right, e.CellBounds.Y, e.CellBounds.Width - symbolRect.Right, e.CellBounds.Height); TextRenderer.DrawText(e.Graphics, node.Name, grid.Font, textRect, grid.ForeColor, TextFormatFlags.VerticalCenter | TextFormatFlags.EndEllipsis); e.Handled = true; // 阻止默认绘制 }

这里几个参数值得说清楚：indent 的 16 像素是经验值，配合 9pt 字体视觉上刚好，改字号时同步调；symbolRect 宽度固定 16，保证加减号点击区域一致；e.Handled = true必须设，否则默认绘制会把文本再画一遍，出现重影。EndEllipsis 是为了长名称不撑破列宽，比自动换行更适合表格。

3. 交互实现：展开折叠、勾选联动与编辑回写

3.1 点击符号展开折叠的命中判断

CellPainting 只负责画，点击要靠 CellMouseClick 判断落点是否在符号区域内。命中判断的坐标要用相对单元格的偏移，而不是整表坐标，否则滚动后会错位。

private void grid_CellMouseClick(object sender, DataGridViewCellMouseEventArgs e) { if (e.RowIndex < 0 || e.ColumnIndex != 0) return; var node = (TreeNodeItem)grid.Rows[e.RowIndex].DataBoundItem; if (!node.HasChildren) return; int indent = node.Level * 16; if (e.Location.X < indent || e.Location.X > indent + 16) return; // 不在符号区 node.IsExpanded = !node.IsExpanded; RefreshGrid(); // 重算可见行并重绑 }

e.Location是相对单元格左上角的坐标，这一点很多人会踩坑，误用鼠标的屏幕坐标导致判断永远不命中。RefreshGrid 内部就是调 2.2 的 BuildVisibleRows 再赋 DataSource，同时记住当前选中行的 Id，重绑后按 Id 找回选中行，避免展开一下选中就跳走。

3.2 勾选父节点联动子节点

带勾选列时，业务上通常要求勾父带全子、子全勾则父勾。这需要在 CellValueChanged 或 CurrentCellDirtyStateChanged 里处理，并且要防止递归触发。做法是加一个布尔标志位，批量改值时置位，改完复位。

private bool _updatingCheck; private void grid_CellValueChanged(object sender, DataGridViewCellEventArgs e) { if (_updatingCheck || e.RowIndex < 0 || e.ColumnIndex != CheckColumnIndex) return; var node = (TreeNodeItem)grid.Rows[e.RowIndex].DataBoundItem; bool isChecked = Convert.ToBoolean(grid.Rows[e.RowIndex].Cells[CheckColumnIndex].Value); _updatingCheck = true; SetChildrenChecked(node, isChecked); // 向下递归设置 UpdateParentChecked(node); // 向上回溯父状态 _updatingCheck = false; }

SetChildrenChecked 递归设置所有后代，UpdateParentChecked 从当前节点往上找，若兄弟全勾则父勾、否则父不勾（或半选，取决于业务）。标志位_updatingCheck是这里的后悔药，没有它，递归里每次赋值都会再触发一次事件，轻则性能崩，重则栈溢出。

3.3 编辑回写与数据一致性

DataGridView 绑定 List 时，单元格编辑默认只改内存对象，不会自动落库。要在 CellEndEdit 里按 Id 找到实体，把改动写回并标记脏数据，退出或点保存时统一提交。注意绑定 List 不支持自动通知，若用 BindingList 可以省掉手动刷新，但树形重算时仍建议整体重绑，避免行索引错乱。

private void grid_CellEndEdit(object sender, DataGridViewCellEventArgs e) { var node = (TreeNodeItem)grid.Rows[e.RowIndex].DataBoundItem; var newValue = grid.Rows[e.RowIndex].Cells[e.ColumnIndex].Value?.ToString(); // 按列名分发到对应字段，这里以 Name 为例 if (grid.Columns[e.ColumnIndex].DataPropertyName == "Name") node.Name = newValue; MarkDirty(node.Id); // 记录待提交的 Id }

用 DataPropertyName 判断列而不是列索引，是因为列顺序调整后索引会变，属性名不会。MarkDirty 维护一个 HashSet，保存时只提交这些 Id，比全表更新省事也更安全。

4. 避坑与排查：五个最容易翻车的点

4.1 展开后选中行乱跳

现象是点一下加号，原本选中的行突然跳到别处。原因是重绑 DataSource 后行索引重建，DataGridView 按索引恢复选中。解决是在重绑前记下选中行的节点 Id，重绑后遍历行按 Id 找回并设 Selected，找不到就清空选中。这个动作建议封装进 RefreshGrid，别每次手动写。

4.2 符号画了但点不中

现象是加减号显示正常，点击没反应。多半是命中判断用了错误坐标系，或者 CellMouseClick 里没排除表头行。排查时先打印 e.Location 和 indent 的值，看是否落在预期区间；再确认 e.RowIndex 是否小于 0。另一个隐蔽原因是列被设成了 ReadOnly 且 SelectionMode 为 FullRowSelect，点击事件仍会触发，但若在 CellContentClick 里判断就会漏，统一用 CellMouseClick 最稳。

4.3 大数据量下卡顿明显

现象是几千节点时展开一次要等一两秒。原因通常是每次重算都新建 List 并触发完整重绘，加上 CellPainting 里频繁创建 Font 或 Brush。解决分两步：可见行集合复用同一个 List 实例，用 Clear 加 AddRange 代替新建；绘制资源提到类字段，别在事件里 new。节点过万时再考虑增量更新和双缓冲，grid.DoubleBuffered = true通过反射设置，能明显减少闪烁。

4.4 勾选联动导致栈溢出

现象是勾一个父节点程序直接崩，异常指向递归。原因是事件递归触发没有拦截。解决就是 3.2 里的标志位，进入批量修改前置位、结束复位，并在递归入口再判一次标志。另外递归深度受层级影响，正常业务层级不会太深，若真遇到超深结构，改成显式栈遍历更保险。

4.5 排序后父子关系错乱

现象是点了列头排序，子节点跑到父节点上面去了。原因是 DataGridView 排的是平表，不理解层级。解决是禁用列头排序，业务排序在构建树时按排序字段递归排好；若确实需要按某列排，只能排同级兄弟，不能跨层。这一点在需求评审时就要和业务方说清楚，别等验收时被提出来。

5. 验收与答辩：怎么证明这棵树是真的能用

验收这套东西，别只看「能展开」这一条。我一般按四层来验：数据层、交互层、边界层、性能层。数据层看加载后层级是否正确、根节点是否唯一、孤儿节点（ParentId 找不到父）是否被兜底挂到根或单独提示；交互层看展开折叠、勾选联动、编辑回写、选中保持这四条是否都通；边界层看空数据、单节点、超深层级、名称超长这几种情况界面是否还正常；性能层看两千节点全展开的耗时和滚动流畅度。

答辩时最容易被问的三个问题，提前准备好答案：一是「为什么不用 TreeView」，答复用表格的列编辑与导出能力，且 TreeView 加列要自绘成本更高；二是「展开状态怎么保持」，答按节点 Id 记忆 IsExpanded，重绑后按 Id 恢复；三是「数据量大了怎么办」，答增量更新可见行集合加双缓冲，并给出实测的节点数与耗时对应关系。把这三问答顺，基本就稳了。

还有个小技巧：验收前把「折叠全部」「展开全部」两个按钮做出来，演示时一键展开再一键折叠，比一个个点更能体现状态管理的完整性，也方便现场复现问题。数据准备上，造一份带三层以上、含空子集和超长名称的测试数据，比拿真实业务数据更能暴露边界问题。

这套方案我在几个管理系统里都跑过，最深的教训是：树形表格的坑几乎都不在「画出来」，而在「状态怎么记、重绑怎么稳」。从那以后我每次做这类模块，都强制先把 Id 记忆和重绑恢复这两件事写成独立方法，再动界面，省下来的调试时间远超前期多花的半小时。希望帮到你。

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