前幾天寫了一篇〈利用 XML 序列化實作程式組態檔〉,用 XML 的序列化與反序列化來達成程式組態檔的功能。本文接著說明 Xml.Serialization 究竟是如何把一個物件序列化的。
先簡單描述一下 XML 文件的結構。在 XML 檔案裡,「元素(Element)」是最基本的結構單位,整份 XML 文件正是由一個又一個元素所組成。
底下是一個元素的例子:
<T Name="Sample">This is Sample</T>
這一整串字元稱為「元素(Element)」,它由好幾個部分構成。其中的 T 稱為元素的「標籤(Tag)」。一個元素包含起始標籤 <T> 與結束標籤 </T>。標籤之間可以包夾「文字(Text)」,本例即為 This is Sample 這個字串;也可以包夾子元素(也就是元素的巢狀)。至於 Name="Sample" 則稱為元素的「屬性(Attribute)」——屬性並非元素的必要成分,可以完全沒有,也可以有多個。
整份 XML 文件就是由許多元素組成的,但只能有一個「根元素(Root)」,其餘元素都是根元素的子元素,或是子元素的子元素。
所謂用 Xml.Serialization 序列化一個物件,就是把物件序列化成一個 XML 的「元素(Element)」。如果某個類別沒有加上任何特性(Attribute),那麼預設情況下,這個類別序列化後的「標籤」就是它的類別名稱,而這個類別的所有公開欄位與公開屬性都會被序列化為子元素;子元素的「標籤」就是欄位名(或屬性名),子元素的「文字」就是欄位值(或屬性值)。
透過 Xml.Serialization 提供的各類特性,我們可以為類別加上標註,从而在序列化時實現自訂的結果。
除了上述特性之外,當遇到集合型別的欄位(屬性)時,Xml.Serialization 會把該欄位序列化成一個「元素」,再把這個集合裡的每個物件序列化成該元素的子元素。
對集合型別的欄位(屬性),可以加上下列特性:
表示把該欄位序列化成一個「元素」,標籤為 E。例如:
<XmlArray("E")> Public Student As List(Of String)
若有三個值 A、B、C,序列化後的結果為:
<E>
<String>A</String>
<String>B</String>
<String>C</String>
</E>
表示把該欄位裡的每個物件序列化為「元素」,標籤為 E。例如:
<XmlArrayItem("E")> Public Student As List(Of String)
同樣以 A、B、C 三個值為例,序列化後的結果為:
<Student>
<E>A</E>
<E>B</E>
<E>C</E>
</Student>
大家可以對照一下這兩個例子的差異。此外,這兩個特性是可以疊加使用的。
集合型別的欄位(屬性)也可以加上 XmlElement("E"),它表示把每個物件序列化為標籤是 E 的「元素」,同時每個元素又各自成為獨立的節點。通俗地說,這是一種「平行序列化」。例如:
<XmlElement("Lan")> Public Student As List(Of String)
同樣以 A、B、C 三個值為例,序列化後的結果為:
<E>
<String>A</String>
</E>
<E>
<String>B</String>
</E>
<E>
<String>C</String>
</E>
以上便是透過 Xml.Serialization 各項特性來掌控物件序列化結果的簡要說明,也歡迎各方先進一同交流切磋。