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(" |
直接解析字串 |
| 選取單一節點 (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);
}
}
`XmlDocument` 是 .NET Framework 早期核心 XML DOM API,雖較 `XDocument` 笨重,但在維護舊系統、相容 .NET 2.0/3.5 環境時仍不可或缺。熟記上表核心 API,配合 XPath 強大查詢能力,可應付絕大多數 XML 讀寫需求。