萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET TreeView 動態載入三層節點完整實作 (PopulateOnDemand)

前言

ASP.NET TreeView 控件支援 PopulateOnDemand 延遲載入,避免一次性載入龐大樹狀結構導致效能問題。本文示範三層節點 (分類 → 產品類型 → 產品) 動態繫結資料庫,含節點展開事件、資料查詢、導航 URL 產生與狀態管理。

一、前端標記

<asp:TreeView ID="TreeView1" runat="server"
    OnTreeNodePopulate="TreeView_TreeNodePopulate"
    ExpandDepth="0"> <!-- 預設只展開根節點 -->
    <NodeStyle Font-Names="微軟雅黑" Font-Size="14px" />
    <HoverNodeStyle ForeColor="Red" />
    <SelectedNodeStyle BackColor="LightBlue" ForeColor="DarkBlue" />
</asp:TreeView>

二、後端完整程式碼

using System;
using System.Data;
using System.Web.UI.WebControls;

public partial class Controls_ProductTypeTree : System.Web.UI.UserControl
{
    private readonly ProductTypeRepository _typeRepo = new ProductTypeRepository();
    private readonly ProductRepository _prodRepo = new ProductRepository();

    protected void TreeView_TreeNodePopulate(object sender, TreeNodeEventArgs e)
    {
        // 避免重複填充
        if (e.Node.ChildNodes.Count > 0) return;

        switch (e.Node.Depth)
        {
            case 0: PopulateCategories(e.Node); break;
            case 1: PopulateProductTypes(e.Node); break;
            case 2: PopulateProducts(e.Node); break;
        }
    }

    // 第 1 層:根分類 (ParentID = 0 或 NULL)
    private void PopulateCategories(TreeNode parentNode)
    {
        DataTable dt = _typeRepo.GetRootCategories(); // SELECT * FROM ProductType WHERE ParentID IS NULL OR ParentID = 0
        foreach (DataRow row in dt.Rows)
        {
            var node = new TreeNode
            {
                Text = row["ProductTypeName"].ToString(),
                Value = row["ProductTypeID"].ToString(),
                NavigateUrl = $"~/WebProductList.aspx?typeId1={row["ProductTypeID"]}",
                PopulateOnDemand = true,           // 允許展開時載入子節點
                SelectAction = TreeNodeSelectAction.Expand // 點擊文字展開而非導航
            };
            parentNode.ChildNodes.Add(node);
        }
        parentNode.Expanded = true; // 預設展開第一層
    }

    // 第 2 層:產品類型 (依父節點 Value 為 ParentID 查詢)
    private void PopulateProductTypes(TreeNode parentNode)
    {
        int parentId = int.Parse(parentNode.Value);
        DataTable dt = _typeRepo.GetChildCategories(parentId);
        foreach (DataRow row in dt.Rows)
        {
            var node = new TreeNode
            {
                Text = row["ProductTypeName"].ToString(),
                Value = row["ProductTypeID"].ToString(),
                NavigateUrl = $"~/WebProductList.aspx?typeId2={row["ProductTypeID"]}",
                PopulateOnDemand = true,
                SelectAction = TreeNodeSelectAction.Expand
            };
            parentNode.ChildNodes.Add(node);
        }
        parentNode.Expanded = false; // 第二層預設摺疊
    }

    // 第 3 層:實際產品 (葉節點)
    private void PopulateProducts(TreeNode parentNode)
    {
        int typeItemId = int.Parse(parentNode.Value);
        DataTable dt = _prodRepo.GetProductsByType(typeItemId);
        foreach (DataRow row in dt.Rows)
        {
            var node = new TreeNode
            {
                Text = row["ProductName"].ToString(),
                Value = row["ProductID"].ToString(),
                NavigateUrl = $"~/WebProductDetail.aspx?id={row["ProductID"]}",
                PopulateOnDemand = false, // 葉節點不再展開
                SelectAction = TreeNodeSelectAction.Select // 點擊導航至詳情頁
            };
            parentNode.ChildNodes.Add(node);
        }
        parentNode.Expanded = false;
    }
}

// Repository 範例 (簡化)
public class ProductTypeRepository
{
    public DataTable GetRootCategories() { /* ADO.NET / EF Core 查詢 */ return new DataTable(); }
    public DataTable GetChildCategories(int parentId) { /* ... */ return new DataTable(); }
}
public class ProductRepository
{
    public DataTable GetProductsByType(int typeItemId) { /* ... */ return new DataTable(); }
}

三、關鍵屬性說明

屬性說明
PopulateOnDemandtrue 時,節點展開會觸發 TreeNodePopulate 事件,由伺服器動態載入子節點。
SelectActionExpand:點擊文字展開/摺疊;Select:點擊選中並導航;None:無反應。
NavigateUrl設定後點擊節點文字會導航 (若 SelectAction=Select),可帶入 QueryString 傳遞 ID。
Expanded初始展開狀態,配合 ExpandDepth 控制預設展開層級。

四、效能與體驗優化

  1. 資料庫索引:ParentID、ProductTypeItemID 必須建立索引。
  2. 分頁/虛擬化:若單一節點下子節點超過 200,建議分頁載入或改用 TreeView 替代方案 (jsTree、zTree 等客戶端樹)。
  3. 快取:根分類、二級分類變動極少,可用 MemoryCache 快取 DataTable 減少 DB 查詢。
  4. Loading 指示器:TreeView 無內建 Loading,可用 CSS .aspNetTreeView .ajax__treeview_loading 或 JavaScript 監聽 PageRequestManager 顯示 Spinner。

五、常見問題

  • 節點重複:PopulateOnDemand 事件可能觸發多次,務必在開頭檢查 e.Node.ChildNodes.Count > 0 直接返回。
  • ViewState 膨脹:大量節點會導致 ViewState 巨大,設定 EnableViewState="false" 或改用客戶端樹。
  • 跨頁回發導航失效:NavigateUrl 若為相對路徑,確保在 Master Page / UserControl 中解析正確 (用 ResolveUrl 或 ~/ 開頭)。
copyright © 萬盛學電腦網 all rights reserved