System.Xml.XmlDocument 是 .NET Framework 內建的 DOM 樣式 XML 解析器,將 XML 載入記憶體形成樹狀結構,支援完整的讀寫、導航、XPath 查詢與驗證。本文系統整理其核心屬性、方法、事件,並提供實戰範例涵蓋載入、查詢、修改、儲存、命名空間處理等常見場景。
| 屬性 | 說明 |
|---|---|
| DocumentElement | 取得根元素 XmlElement |
| ChildNodes / FirstChild / LastChild | 節點樹導航 |
| InnerText / InnerXml / OuterXml | 取得/設定節點文字或標記內容 |
| Name / LocalName / NamespaceURI | 節點名稱與命名空間資訊 |
| NodeType | 節點型別 (Element, Attribute, Text, Comment...) |
| OwnerDocument | 所屬的 XmlDocument 實例 |
| PreserveWhitespace | 是否保留元素間空白 (預設 false) |
| XmlResolver | 外部資源解析器 (DTD/Schema/實體參考) |
// 載入
doc.Load("file.xml"); // 檔案/URL/Stream
doc.LoadXml(" "); // 字串
doc.Load(reader); // XmlReader
// 儲存
doc.Save("file.xml");
doc.Save(stream);
doc.Save(writer); // XmlWriter
doc.CreateElement("node", "ns"); // 元素
doc.CreateAttribute("attr", "ns"); // 屬性
doc.CreateTextNode("text"); // 文字節點
doc.CreateCDataSection("data"); // CDATA
doc.CreateComment("comment"); // 註解
doc.CreateXmlDeclaration("1.0", "utf-8", null);
doc.GetElementById("id");
doc.GetElementsByTagName("item");
doc.SelectNodes("//book[@price>30]"); // XPath
doc.SelectSingleNode("/root/item[1]");
parent.AppendChild(newNode);
parent.InsertBefore(newNode, refNode);
parent.InsertAfter(newNode, refNode);
parent.ReplaceChild(newNode, oldNode);
parent.RemoveChild(oldNode);
parent.RemoveAll();
doc.ImportNode(externalNode, deep: true); // 跨文檔匯入
node.CloneNode(deep: true); // 深層複製
doc.Schemas.Add("ns", "schema.xsd");
doc.Validate((sender, e) => { /* 處理驗證錯誤 */ });
文檔層級事件可攔截節點異動:
doc.NodeInserted += (s, e) => Log.Debug($"節點插入: {e.Node.Name}");
doc.NodeRemoved += (s, e) => Log.Debug($"節點移除: {e.Node.Name}");
doc.NodeChanged += (s, e) => Log.Debug($"節點值變更: {e.Node.Value}");
var doc = new XmlDocument { PreserveWhitespace = true };
doc.Load(Server.MapPath("~/App_Data/Products.xml"));
// XPath 查詢價格 > 100 的產品
var nodes = doc.SelectNodes("/Products/Product[Price > 100]");
foreach (XmlElement el in nodes) {
el.SetAttribute("highlight", "true");
var priceEl = (XmlElement)el.SelectSingleNode("Price");
priceEl.InnerText = (decimal.Parse(priceEl.InnerText) * 1.1m).ToString("0.00");
}
// 新增產品
var newProd = doc.CreateElement("Product");
newProd.SetAttribute("id", "P999");
newProd.AppendChild(doc.CreateElement("Name")).InnerText = "新產品";
newProd.AppendChild(doc.CreateElement("Price")).InnerText = "199.00";
doc.DocumentElement.AppendChild(newProd);
// 儲存 (保留格式)
using (var writer = XmlWriter.Create(Server.MapPath("~/App_Data/Products_Updated.xml"),
new XmlWriterSettings { Indent = true, Encoding = Encoding.UTF8 })) {
doc.Save(writer);
}
var nsmgr = new XmlNamespaceManager(doc.NameTable);
nsmgr.AddNamespace("ns", "https://example.com/schema");
var nodes = doc.SelectNodes("//ns:Item", nsmgr);
XmlReader (前向唯讀) 或 XStreamingElement (LINQ to XML 流式)。XDocument (LINQ to XML) API 更現代、語法更簡潔,建議新專案優先採用。XmlDocument.Validate 仍為內建最完整選項。XmlDocument 雖屬舊世代 API,但在維護既有系統、需完整 DOM 操作、Schema 驗證時仍不可或缺;熟練其 XPath 與命名空間處理能大幅提升 XML 處理效率。