在 .Net 中,用微軟提供的 Internet Explorer Web Controls 就能很方便地做出樹狀列表。這套控制項集合包含 MultiPage、TabStrip、Toolbar、TreeView 四個控制項。
官方文件對使用方法有詳細說明,其中提到 TreeView 支援以 XML 檔作為資料來源——畢竟 XML 結構本身就是樹狀的。網路上也有不少資料介紹了這種直接用 XML 餵資料的做法。
本文要談的是另一條路:自己寫一段解析程序,把自訂格式的 XML 讀進 TreeView。老實說,後來查到控制項本身就能吃 XML,這個方法已經顯得多此一舉,寫出來純粹是為了共同學習。
拿到控制項時我對用法還不熟,但為了以後能方便地 reuse,決定用 XML 存節點資訊,於是設計了這樣的結構:
<?xml version="1.0" encoding="UTF-8"?>
<treeview>
<nodes>
<text>根節點</text>
<link></link>
<target>_self</target>
<description></description>
<node>
<text>測試節點-1</text>
<link>/test1.aspx</link>
<target>MainFrame</target>
<description></description>
</node>
<node>
<text>測試節點-2</text>
<link>/test2.aspx</link>
<target>_top</target>
<description></description>
</node>
</nodes>
</treeview>
約定:treeview 為根節點,nodes 為父級節點,node 為子節點。nodes 可以嵌套也可以並行,node 只能並行。
TreeViewParse:進入點,從 XML 文件讀取節點並灌進 TreeView。
private void TreeViewParse(System.Xml.XmlNode document,
Microsoft.Web.UI.WebControls.TreeView treeView)
{
if (document.Name != "treeview") return;
foreach (System.Xml.XmlNode node in document.ChildNodes)
{
if (node.Name != "nodes") return;
this.NodesParse(node, treeView, null);
}
}
NodesParse:解析父級節點。它先建一個 TreeNode,再依子節點名稱分派處理——text 對應 Text、link 對應 NavigateUrl、target 對應 Target,遇到 nodes 或 node 則遞迴下去。最後依 treeNode 是否為 null,決定把新節點掛到 treeView 還是父節點下。
private void NodesParse(System.Xml.XmlNode document,
Microsoft.Web.UI.WebControls.TreeView treeView,
Microsoft.Web.UI.WebControls.TreeNode treeNode)
{
if (document.Name != "nodes") return;
TreeNode child = new Microsoft.Web.UI.WebControls.TreeNode();
foreach (System.Xml.XmlNode node in document.ChildNodes)
{
string name = (node.Name != null ? node.Name : "");
switch (name.Trim().ToLower())
{
case "text":
child.Text = node.InnerText;
break;
case "link":
child.NavigateUrl = node.InnerText;
break;
case "target":
child.Target = node.InnerText;
break;
case "nodes":
NodesParse(node, treeView, child);
break;
case "node":
NodeParse(node, treeView, child);
break;
}
}
if (treeNode == null) treeView.Nodes.Add(child);
else treeNode.Nodes.Add(child);
}
NodeParse:解析子節點,邏輯與 NodesParse 相同,只是不含 nodes 分支,最後一律掛到傳入的父節點下。
private void NodeParse(System.Xml.XmlNode document,
Microsoft.Web.UI.WebControls.TreeView treeView,
Microsoft.Web.UI.WebControls.TreeNode treeNode)
{
TreeNode child = new Microsoft.Web.UI.WebControls.TreeNode();
foreach (System.Xml.XmlNode node in document.ChildNodes)
{
string name = (node.Name != null ? node.Name : "");
switch (name.Trim().ToLower())
{
case "text":
child.Text = node.InnerText;
break;
case "link":
child.NavigateUrl = node.InnerText;
break;
case "target":
child.Target = node.InnerText;
break;
case "nodes":
NodesParse(node, treeView, child);
break;
}
}
treeNode.Nodes.Add(child);
}
Microsoft.Web.UI.WebControls.TreeView msTreeView = new Microsoft.Web.UI.WebControls.TreeView();
System.Xml.XmlDocument document = new System.Xml.XmlDocument();
document.Load(System.Web.HttpContext.Current.Server.MapPath(this.XMLDocument));
msTreeView.Nodes.Clear();
TreeViewParse(document.DocumentElement, msTreeView);
做到這裡,自訂的 XML 就能正確顯示成樹狀目錄了。
我原本還覺得不夠方便,於是把它包成一個控制項組件,之後只要拖到頁面上就能用。直到後來查資料才發現,TreeView 控制項本身早就支援直接讀取 XML 檔。
所以這段程式最終的定位,就只是一份用來練習的代碼——但也正好說明一件事:動手做一遍,比直接查文件更容易真正理解背後的運作機制。