C# TreeView 控制項完整操作指南：節點新增、刪除、展開摺疊實戰

TreeView 是 Windows Forms 中呈現階層式資料的核心控制項，由 TreeView 容器與 TreeNode 節點物件組成。本文系統整理節點新增 (子/兄)、刪除、展開摺疊等核心操作，並提供完整可執行範例程式碼。

核心物件模型

• TreeView：容器控制項，管理根節點集合 Nodes、選取節點 SelectedNode、影像清單 ImageList 等。
• TreeNode：節點物件，擁有 Nodes (子節點集合)、Parent (父節點)、Text/Tag、ImageIndex、Expand()/Collapse() 等成員。

三大基本操作模式

1. 新增子節點

if (treeView1.SelectedNode == null)
{
    MessageBox.Show("請先選取節點");
    return;
}

TreeNode child = new TreeNode("新子節點文字");
treeView1.SelectedNode.Nodes.Add(child); // 加入至 SelectedNode 的子節點集合
treeView1.SelectedNode = child;          // 選取新節點
treeView1.ExpandAll();                   // 展開顯示

2. 新增兄弟節點

if (treeView1.SelectedNode == null) return;

TreeNode sibling = new TreeNode("新兄弟節點文字");
// 關鍵差異：透過 Parent.Nodes 加入，而非 SelectedNode.Nodes
treeView1.SelectedNode.Parent?.Nodes.Add(sibling);
treeView1.ExpandAll();

注意：若選取的是根節點 (無 Parent)，Parent 為 null，需加入判斷或改用 treeView1.Nodes.Add(...)。

3. 刪除節點

if (treeView1.SelectedNode == null) return;

// 若有子節點需先清除，或遞迴刪除
if (treeView1.SelectedNode.Nodes.Count > 0)
{
    MessageBox.Show("請先刪除所有子節點");
    return;
}

treeView1.SelectedNode.Remove(); // 從父節點集合移除

展開/摺疊操作

完整範例：含右鍵選單的互動式 TreeView

using System;
using System.Drawing;
using System.Windows.Forms;

public class TreeViewDemoForm : Form
{
    private TreeView treeView1;
    private TextBox txtNodeName;
    private ContextMenuStrip ctxMenu;
    private ToolStripMenuItem miAddChild, miAddSibling, miDelete;
    private Button btnExpandAll, btnCollapseAll, btnExpandOne;

    public TreeViewDemoForm()
    {
        InitializeComponent();
        // 初始根節點
        treeView1.Nodes.Add("根節點");
        treeView1.Nodes[0].Expand();
    }

    private void InitializeComponent()
    {
        // 控制項初始化與配置 (略)
        // 重點事件繫結：
        miAddChild.Click += (s, e) => AddChildNode();
        miAddSibling.Click += (s, e) => AddSiblingNode();
        miDelete.Click += (s, e) => DeleteNode();
        treeView1.MouseDown += (s, e) => 
        { if (e.Button == MouseButtons.Right) ctxMenu.Show(treeView1, e.Location); };
        btnExpandAll.Click += (s, e) => treeView1.Nodes[0]?.ExpandAll();
        btnCollapseAll.Click += (s, e) => treeView1.Nodes[0]?.Collapse();
        btnExpandOne.Click += (s, e) => treeView1.SelectedNode?.Expand();
    }

    private void AddChildNode()
    {
        if (treeView1.SelectedNode == null || string.IsNullOrWhiteSpace(txtNodeName.Text)) return;
        var node = new TreeNode(txtNodeName.Text);
        treeView1.SelectedNode.Nodes.Add(node);
        treeView1.SelectedNode = node;
        treeView1.ExpandAll();
    }

    private void AddSiblingNode()
    {
        if (treeView1.SelectedNode == null || string.IsNullOrWhiteSpace(txtNodeName.Text)) return;
        var parent = treeView1.SelectedNode.Parent ?? treeView1; // 根節點無 Parent 時加至 TreeView.Nodes
        var node = new TreeNode(txtNodeName.Text);
        if (parent is TreeView tv) tv.Nodes.Add(node);
        else ((TreeNode)parent).Nodes.Add(node);
        treeView1.ExpandAll();
    }

    private void DeleteNode()
    {
        if (treeView1.SelectedNode == null) return;
        if (treeView1.SelectedNode.Nodes.Count > 0)
        {
            MessageBox.Show("請先刪除子節點");
            return;
        }
        treeView1.SelectedNode.Remove();
    }
}

進階技巧與最佳實務

• Tag 屬性攜帶資料：node.Tag = entityId 或完整物件，避免以 Text 查找。
• 虛擬模式/延遲載入：大量節點時，僅建立可見節點，BeforeExpand 事件動態載入子節點。
• 拖放重新排序：設定 AllowDrop=true，處理 ItemDrag, DragEnter, DragDrop 實作節點移動。
• 搜尋與過濾：遞迴 FindNodeByText 或 LINQ treeView1.Nodes.Cast<TreeNode>().SelectMany(n => n.Nodes.Cast<TreeNode>())。
• 資料繫結替代方案：需求複雜時考慮 ObjectListView (第三方) 或自訂繼承 TreeView 實作 IBindingList (參考文章 12424)。

常見陷阱

熟練掌握 TreeNode.Nodes、Parent、Expand/Collapse 三大核心概念，即可靈活操作 TreeView 滿足多數階層式資料呈現需求。

1. 上一篇文章： C# 資料庫交易 (Transaction) 原理與實戰完整指南
2. 下一篇文章： 用 C# 製作字幕式螢幕保護程式

關於C#

GridView 進階技巧：以省略號替換過長字串並支援分頁

需求背景 在 ASP.NET WebForms 開發中，Gr

WinForms 仿 QQ 面板側邊欄：Dock 布局與動態切換實現

無需第三方控件，純 WinForms 實現類似 QQ 側邊欄

C# 除法運算深度解析：整數截斷、浮點數 IEEE 754、decimal 高精度與除零行為

除法運算在不同數值類型上展現截然不同的語意：整數向零截斷、浮

SQL Server CLR 整合：使用 C# 編寫托管存儲過程完整教程

繼托管觸發器後，本文介紹使用 C# 編寫 托管存儲過程。適用