WCF 序列化引擎核心：XmlDictionaryWriter 深度解析與編碼效能比較

XmlDictionaryWriter：Message 序列化與編碼的主力

繼承 System.Xml.XmlWriter，為抽象類別，透過工廠方法建立實例，包裝 Stream，提供 Write 方法族群。核心差異在於：支援 XmlDictionary 進行語意壓縮，專為 Message 序列化/編碼設計。

四大編碼工廠方法詳細比較

1. CreateDictionaryWriter：包裝現有 XmlWriter

XmlWriter xmlWriter = XmlWriter.Create(stream);
XmlDictionaryWriter writer = XmlDictionaryWriter.CreateDictionaryWriter(xmlWriter);

僅供 API 相容性使用，無額外功能。

2. CreateTextWriter：文字編碼（UTF-8/UTF-16 LE/BE）

using (XmlDictionaryWriter writer = XmlDictionaryWriter.CreateTextWriter(stream, Encoding.UTF8, false)) {
    writer.WriteStartDocument();
    writer.WriteElementString("SongName", "urn:ContosoRockabilia", "Aqualung");
}

• ownsStream 參數控制 Dispose 是否關閉 Stream。
• 輸出標準 XML，含宣告與命名空間，約 97 位元組（UTF-8）。

3. CreateMtomWriter：MTOM 多部件編碼

產出 MIME 多部件訊息，適合大型二進位資料傳輸。兩個多載提供不同控制層級：

• 簡易版：自動產生 Boundary、Content-ID、Start-Info。
• 進階版：手動指定 Content-Type、Boundary、Start URI，甚至移除開頭 MIME 標頭（writeMessageHeaders=false）。

警示：過度客製化 MIME 結構可能破壞互通性，違背 MTOM 設計初衷。

4. CreateBinaryWriter：二進制編碼（效能最佳）

四個多載支援：

• 靜態字典：傳入預建 XmlDictionary，雙方預先共享詞彙表。
• 動態會話：XmlBinaryWriterSession 自動在串流開頭產生 Key-Value 對，免除帶外共享字典的挑戰，但有效能成本。
• 無字典：直接寫入字串，無壓縮。

XmlDictionary 語意壓縮實測：文字 vs 二進制，有無字典

字典僅對二進制編碼生效。文字編碼因 UTF-8/16 規範固定，無壓縮空間。API 設計允許同一方法接受 String 或 XmlDictionaryString，實現編碼無關的彈性程式碼。

效能結論與產業展望

• 二進制編碼 + 字典 = 最小傳輸體積 = 最高效率。
• WCF 打破「XML 文字編碼效能差」迷思，產出緊湊二進制 XML。
• 目前二進制編碼為 WCF 專有，期待產業標準化以利跨平台互通。