萬盛學電腦網

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

ASP.NET XML 操作完整速查手冊:XmlDocument 常用 API 與實戰範例

命名空間引用

using System.Xml;

核心類別與常用操作對照表

操作目的關鍵 API / 程式碼片段備註
初始化 XmlDocument XmlDocument xml = new XmlDocument(); 代表整份 XML 文件的記憶體樹狀結構 (DOM)
載入 XML 檔案 xml.Load(path);
xml.Load(HttpContext.Current.Server.MapPath("~/Data/7in10.xml"));
支援檔案路徑、Stream、Url、XmlReader
載入 XML 字串 xml.LoadXml("test"); 直接解析字串
選取單一節點 (XPath) XmlNode root = xml.SelectSingleNode("/root"); 回傳第一個符合的節點
選取多個同名節點 XmlNodeList nodeList = xml.SelectNodes("/Root/News"); 回傳節點集合,可迭代
取得直接子節點 XmlNodeList children = root.ChildNodes; 包含元素、文字、註解等所有節點類型
判斷是否有子節點 bool hasChildren = root.HasChildNodes; 布林值
建立新元素節點 XmlElement node = xml.CreateElement("News"); 必須透過 XmlDocument 建立,才屬於同一文件
附加子節點至父節點末尾 root.AppendChild(node);
插入子節點至指定位置之前 root.InsertBefore(node, root.ChildNodes[i]); 參考節點必須是父節點的直接子節點
設定/新增屬性 node.SetAttribute("id", "11111"); 屬性不存在則新增,存在則更新
取得屬性值 string id = node.Attributes["id"].Value; 建議先檢查 `node.Attributes["id"] != null`
取得節點內文本 string text = node.InnerText; 包含所有子孫文字內容,不含標記
取得/設定節點內部 XML string inner = node.InnerXml;
node.InnerXml = "新內容";
包含子標記
移除節點 parent.RemoveChild(node);
儲存 XML 檔案 xml.Save(path);
xml.Save(HttpContext.Current.Server.MapPath("~/Data/7in10.xml"));
會自動產生 XML 宣告與縮排 (需設定 XmlWriterSettings)

完整實戰範例:讀取、修改、新增、儲存

public void UpdateNewsXml(string filePath, string newsId, string newTitle, string newContent)
{
    var xml = new XmlDocument();
    xml.Load(filePath);

    // 1. 找到目標節點 (假設結構: /Root/News[@id='...'])
    XmlNode targetNode = xml.SelectSingleNode($"/Root/News[@id='{newsId}']");
    
    if (targetNode != null)
    {
        // 2. 更新屬性與子節點文字
        targetNode.Attributes["id"].Value = newsId; // 通常 id 不變,示範用
        targetNode.SelectSingleNode("Title").InnerText = newTitle;
        targetNode.SelectSingleNode("Content").InnerText = newContent;
        targetNode.SelectSingleNode("UpdateTime").InnerText = DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss");
    }
    else
    {
        // 3. 新增節點範例
        XmlElement newNode = xml.CreateElement("News");
        newNode.SetAttribute("id", newsId);
        newNode.InnerXml = $"{newTitle}{newContent}{DateTime.Now:yyyy-MM-dd HH:mm:ss}";
        
        XmlNode root = xml.SelectSingleNode("/Root");
        root.AppendChild(newNode);
    }

    // 4. 儲存 (建議使用 XmlWriterSettings 控制縮排)
    var settings = new XmlWriterSettings { Indent = true, IndentChars = "  ", Encoding = new UTF8Encoding(false) };
    using (var writer = XmlWriter.Create(filePath, settings))
    {
        xml.Save(writer);
    }
}

進階主題

  • XPath 語法:`//News` (所有層級)、`/Root/News[1]` (第一個)、`/Root/News[@id='1']` (屬性過濾)、`/Root/News[Title='標題']` (內容過濾)。
  • 命名空間處理:XML 若有 `xmlns`,需使用 `XmlNamespaceManager` 註冊前綴後才能 XPath 查詢。
  • 大型 XML 效能:`XmlDocument` 將整份文件載入記憶體,大檔案 (>10MB) 易造成 OOM。改用 `XmlReader` (唯讀流式) 或 `XmlWriter` (寫入流式) 處理。
  • LINQ to XML (XDocument):.NET 3.5+ 推薦使用 `System.Xml.Linq`,語法更直觀、支援 LINQ 查詢、建構 XML 更方便。

總結

`XmlDocument` 是 .NET Framework 早期核心 XML DOM API,雖較 `XDocument` 笨重,但在維護舊系統、相容 .NET 2.0/3.5 環境時仍不可或缺。熟記上表核心 API,配合 XPath 強大查詢能力,可應付絕大多數 XML 讀寫需求。

copyright © 萬盛學電腦網 all rights reserved