萬盛學電腦網

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

ASP.NET XmlDocument 類別完整操作指南:屬性、方法、事件與實戰範例

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

節點建立 (Factory Methods)

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) => { /* 處理驗證錯誤 */ });

事件模型 (NodeChanged 等)

文檔層級事件可攔截節點異動:

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}");

實戰範例:讀取、XPath 查詢、修改並儲存

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);

效能與替代方案

  • 大型 XML (>10MB):DOM 全載入記憶體易致 OOM,改用 XmlReader (前向唯讀) 或 XStreamingElement (LINQ to XML 流式)。
  • 頻繁查詢/修改:XDocument (LINQ to XML) API 更現代、語法更簡潔,建議新專案優先採用。
  • Schema 驗證:XmlDocument.Validate 仍為內建最完整選項。

XmlDocument 雖屬舊世代 API,但在維護既有系統、需完整 DOM 操作、Schema 驗證時仍不可或缺;熟練其 XPath 與命名空間處理能大幅提升 XML 處理效率。

copyright © 萬盛學電腦網 all rights reserved