XML 是一項熱門技術,它能引起廣泛興趣,一個主要原因在於它十分簡單——每個程式設計師都能輕易看懂一份 XML 文件、理解它包含的內容。
.NET 中包含了許多支援 XML 的類,讓程式設計師使用 XML 就像理解 XML 文件一樣簡單。本文將介紹其中一個實用的類——XmlTextWriter,示範如何用它把 XML 寫入文件。
XmlTextWriter 類允許你把 XML 寫到一個文件中,它包含許多方法與屬性,能讓你更輕鬆地處理 XML。使用前必須先建立一個新的 XmlTextWriter 對象,然後把各種 XML 元素加入其中。常用方法如下:
方法 —— 描述
WriteStartDocument —— 書寫版本為 "1.0" 的 XML 聲明
WriteEndDocument —— 關閉任何打開的元素或屬性
Close —— 關閉流
WriteDocType —— 寫出具有指定名稱和可選屬性的 DOCTYPE 聲明
WriteStartElement —— 寫出指定的開始標記
WriteEndElement —— 關閉一個元素
WriteFullEndElement —— 關閉一個元素,並總是寫入完整的結束標記
WriteElementString —— 寫出包含字串值的元素
WriteStartAttribute —— 書寫屬性的起始內容
WriteEndAttribute —— 關閉上一個 WriteStartAttribute 調用
WriteRaw —— 手動書寫原始標記
WriteString —— 書寫一個字串
WriteAttributeString —— 寫出具有指定值的屬性
WriteCData —— 寫出包含指定文本的 <![CDATA[...]]> 塊
WriteComment —— 寫出包含指定文本的註釋 <!--...-->
WriteWhiteSpace —— 寫出給定的空白
WriteProcessingInstruction —— 寫出在名稱和文本之間帶有空格的處理指令,如 <?name text?>
以下範例先建立一個文件,加入一些元素,再關閉它,最後產生名為 titles.xml 的文件:
using System;
using System.IO;
using System.XML;
public class Sample
{
public static void Main()
{
XmlTextWriter writer = new XmlTextWriter("titles.XML", null);
//寫入根元素
writer.WriteStartElement("items");
//加入子元素
writer.WriteElementString("title", "Unreal Tournament 2003");
writer.WriteElementString("title", "C&C: Renegade");
writer.WriteElementString("title", "Dr. Seuss's ABC");
//關閉根元素,並書寫結束標簽
writer.WriteEndElement();
//將XML寫入文件並關閉XmlTextWriter
writer.Close();
}
}
編譯並執行後,會產生如下內容:
<items>
<title>Unreal Tournament 2003</title>
<title>C&C: Renegade</title>
<title>Dr. Seuss's ABC</title>
</items>
程式先建立名為 writer 的 XmlTextWriter 對象並關聯到 titles.xml,接著用 WriteStartElement 建立 items 根元素的開始標記,再用 WriteElementString 建立三個子元素(第一個參數為標籤,第二個參數為元素值)。加入所有元素後,用 WriteEndElement 關閉最近打開的元素,最後用 Close 把資訊寫入文件並關閉 writer。
以下範例用到更多方法,功能更完善:
using System;
using System.IO;
using System.XML;
public class Sample
{
public static void Main()
{
XmlTextWriter writer = new XmlTextWriter("myMedia.XML", null);
//使用自動縮進便於閱讀
writer.Formatting = Formatting.Indented;
//書寫根元素
writer.WriteStartElement("items");
//開始一個元素
writer.WriteStartElement("item");
//向先前創建的元素中添加一個屬性
writer.WriteAttributeString("rating", "R");
//添加子元素
writer.WriteElementString("title", "The Matrix");
writer.WriteElementString("format", "DVD");
//關閉item元素
writer.WriteEndElement();
//在節點間添加一些空格
writer.WriteWhitespace("\n");
//使用原始字符串書寫第二個元素
writer.WriteRaw("<item>" +
"<title>BloodWake</title>" +
"<format>XBox</format>" +
"</item>");
//使用格式化的字符串書寫第三個元素
writer.WriteRaw("\n <item>\n" +
" <title>Unreal Tournament 2003</title>\n" +
" <format>CD</format>\n" +
" </item>\n");
//關閉根元素
writer.WriteFullEndElement();
//將XML寫入文件並關閉writer
writer.Close();
}
}
編譯運行後會得到 myMedia.XML 文件,內容如下:
<items>
<item rating="R">
<title>The Matrix</title>
<format>DVD</format>
</item>
<item>
<title>BloodWake</title>
<format>XBox</format>
</item>
<item>
<title>Unreal Tournament 2003</title>
<format>CD</format>
</item>
</items>
要記住一件事:當你呼叫方法開始一個操作時,需要在程式合適的地方呼叫方法結束它。例如呼叫了 WriteStartElement,就必須用 WriteEndElement 關閉元素(這和堆疊的工作方式很相似——EndElement 總是關閉最近用 StartElement 打開的那個元素)。使用 XmlTextWriter 十分容易,而它僅是 .NET 眾多 XML 類中的一個,其他 XML 類同樣易於使用。