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(); }
}
| 屬性 | 說明 |
|---|---|
PopulateOnDemand | true 時,節點展開會觸發 TreeNodePopulate 事件,由伺服器動態載入子節點。 |
SelectAction | Expand:點擊文字展開/摺疊;Select:點擊選中並導航;None:無反應。 |
NavigateUrl | 設定後點擊節點文字會導航 (若 SelectAction=Select),可帶入 QueryString 傳遞 ID。 |
Expanded | 初始展開狀態,配合 ExpandDepth 控制預設展開層級。 |
ParentID、ProductTypeItemID 必須建立索引。TreeView 替代方案 (jsTree、zTree 等客戶端樹)。MemoryCache 快取 DataTable 減少 DB 查詢。TreeView 無內建 Loading,可用 CSS .aspNetTreeView .ajax__treeview_loading 或 JavaScript 監聽 PageRequestManager 顯示 Spinner。PopulateOnDemand 事件可能觸發多次,務必在開頭檢查 e.Node.ChildNodes.Count > 0 直接返回。EnableViewState="false" 或改用客戶端樹。NavigateUrl 若為相對路徑,確保在 Master Page / UserControl 中解析正確 (用 ResolveUrl 或 ~/ 開頭)。