C# XML 寫入入門：XmlTextWriter 建構與核心方法詳解

為什麼要用程式產生 XML？

動態產生 XML 應用廣泛：安裝程式依使用者選項產生設定檔、依 XML 初始化應用程式、資料交換格式轉換等。

XmlWriter 架構與 XmlTextWriter

XmlWriter 為抽象類別，實際使用其具體實作 XmlTextWriter，提供完整屬性與方法支援 XML 寫入。

三種建構函式

public XmlTextWriter(TextWriter writer);
public XmlTextWriter(Stream stream, Encoding encoding);
public XmlTextWriter(string filename, Encoding encoding);

1. 傳入現有 TextWriter（有序字元流）
2. 指定資料流（FileStream、MemoryStream、NetworkStream 等）與編碼，預設 UTF-8
3. 指定檔案路徑（存在則覆寫）與編碼

核心寫入方法

文件宣告：WriteStartDocument / WriteEndDocument

// 輸出：
WriteStartDocument();
WriteEndDocument();  // 關閉開啟元素/屬性，重置為 Start 狀態

元素操作：WriteStartElement / WriteEndElement

多載：

WriteStartElement(string localName)
WriteStartElement(string localName, string ns)
WriteStartElement(string prefix, string localName, string ns)

WriteEndElement：輸出對應結束標籤，空元素輸出 `/>`

屬性操作：WriteStartAttribute / WriteEndAttribute

多載：

WriteStartAttribute(string localName, string ns)
WriteStartAttribute(string prefix, string localName, string ns)

WriteEndAttribute：關閉屬性寫入

實務建議

• 善用 using 區塊確保資源釋放
• 配合 XmlWriterSettings 控制縮排、編碼、省略宣告等輸出格式
• 大量資料時考慮 MemoryStream 避免頻繁 I/O