C# WinForms递归转换对象树到TreeView出现层级与选中异常

问题现象 #

使用基于抽象类Node的对象树构建WinForms的TreeView时，出现以下问题：

• 向二级节点添加子节点时，新节点显示名称与父节点重复；
• 选中该重复名称的节点时，通过GetNodeByID方法返回的是其父节点；
• 无法添加三级及以上节点，树结构最多只能到二级。

运行示例：

Node added: [ID:0, Name:Root0]     // 添加第一个节点（成功）
Node added: [ID:1, Name:Root1]     // 添加第二个节点（成功）
Item selected: [ID:0, Name:Root0]  // 通过GetNodeByID选中第一个节点（成功）
Node added: [ID:2, Name:Child0]    // 向选中节点添加子节点（实际未正确显示）
Item selected: [ID:0, Name:Root0]  // 尝试选中ID为2的节点（返回父节点）

错误原因分析 #

问题根源在于递归构建TreeView的AddTreeItem方法逻辑完全错误：

1. 重复添加父节点：该方法接收一个Node和对应的父TreeNode后，首先创建了一个与传入Node同名的TreeNode并添加到父节点下，相当于把父节点本身重复添加了一次，而非添加该Node的子节点。
2. 遗漏叶子节点：遍历Node的子节点时，仅当子节点自身还有子节点时才递归调用，导致没有子节点的叶子节点（如示例中的Child0）根本不会被添加到TreeView中。
3. Tag与实际Node不匹配：错误添加的重复节点使用了父节点的ID作为Tag，导致选中该节点时，GetNodeByID返回的是父节点而非预期的子节点。

修复代码 #

1. 完善Node类的公开属性 #

确保Node类的属性可被外部访问：

abstract class Node
{
    byte _id;
    string _name;
    List<Node> _children = new List<Node>();

    public Node()
    {
        this.ID = (byte)Iterator.GenerateID;
    }

    public byte ID { get => _id; set => _id = value; }
    public string Name { get => _name; set => _name = value; }
    public List<Node> Children { get => _children; }

    public void AddChild(Node child)
    {
        _children.Add(child);
    }
}

2. 重构TreeView更新方法 #

替换错误的AddTreeItem，改为正确递归添加子节点的逻辑：

private void UpdateTree()
{
    tv_scene.BeginUpdate();
    tv_scene.Nodes.Clear();
    TreeNode rootTree = new TreeNode("Scene");
    tv_scene.Nodes.Add(rootTree);
    
    foreach (Node n in _root)
    {
        TreeNode tn = new TreeNode(n.Name);
        tn.Tag = n.ID;
        // 递归添加当前节点的所有子节点
        AddChildNodesToTree(n.Children, tn);
        rootTree.Nodes.Add(tn);
    }
    
    tv_scene.ExpandAll();
    tv_scene.EndUpdate();
}

// 负责将Node子节点集合添加到指定TreeView父节点，并递归处理深层子节点
private void AddChildNodesToTree(List<Node> childNodes, TreeNode parentTreeNode)
{
    foreach (Node childNode in childNodes)
    {
        TreeNode childTreeNode = new TreeNode(childNode.Name);
        childTreeNode.Tag = childNode.ID;
        parentTreeNode.Nodes.Add(childTreeNode);
        // 递归处理当前子节点的子节点（无论是否为空，为空则不执行循环）
        AddChildNodesToTree(childNode.Children, childTreeNode);
    }
}

3. GetNodeByID方法无需修改 #

原方法的递归查找逻辑是正确的，修复TreeView节点的Tag匹配后，即可正常返回对应Node。

修复效果验证 #

• 向二级节点添加子节点时，子节点会以正确名称显示在父节点下，Tag设置为自身ID；
• 选中子节点时，GetNodeByID会正确返回对应的子Node对象；
• 支持无限层级添加节点，递归逻辑会自动处理所有层级的子节点。

内容的提问来源于stack exchange，提问作者Boyfinn