.NET 的 XmlSerializer 讓「物件 ↔ XML」的轉換變得非常省事。以下用一組簡單的類別說明完整流程。
[Serializable]
public class Person {
private string name;
public string Name {
get { return name; }
set { name = value; }
}
public string Sex;
public int Age = 31;
public Course[] Courses;
public Person() { }
public Person(string Name) {
name = Name;
Sex = "男";
}
}
[Serializable]
public class Course {
public string Name;
[XmlIgnore]
public string Description;
public Course() { }
public Course(string name, string description) {
Name = name;
Description = description;
}
}
class Test {
// 序列化:物件 → XML
public void Serialize() {
Person c = new Person("cyj");
c.Courses = new Course[2];
c.Courses[0] = new Course("英語", "交流工具");
c.Courses[1] = new Course("數學", "自然科學");
XmlSerializer xs = new XmlSerializer(typeof(Person));
Stream stream = new FileStream("c:\\cyj.xml",
FileMode.Create, FileAccess.Write, FileShare.ReadWrite);
xs.Serialize(stream, c);
stream.Close();
}
// 反序列化:XML → 物件
public void Deserialize() {
XmlSerializer xs = new XmlSerializer(typeof(Person));
Stream stream = new FileStream("c:\\cyj.xml",
FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
Person p = (Person)xs.Deserialize(stream);
Console.WriteLine(p.Name);
Console.WriteLine(p.Age.ToString());
Console.WriteLine(p.Courses.Length.ToString());
Console.Read();
}
}
<?XML version="1.0"?> <Person xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"> <Sex>男</Sex> <Age>31</Age> <Courses> <Course> <Name>英語</Name> </Course> <Course> <Name>數學</Name> </Course> </Courses> <Name>cyj</Name> </Person>
一定要有不帶參數的建構子。XmlSerializer 反序列化時會先建立物件實例再逐一填入欄位,因此預設建構子是必要條件。
XmlIgnore 的效果很明顯。Course.Description 被標上 [XmlIgnore] 之後完全不出現在輸出中。這在處理敏感欄位或純執行期狀態時很好用。
輸出順序不必然等於宣告順序。注意 XML 中 Name 被排在最後。這是因為屬性(property)與欄位(field)在序列化時的處理順序不同,序列化器會先處理欄位、再處理屬性。若順序對你有意義,改用 Element 的 Order 參數或統一改用屬性即可。
私有欄位不會被序列化。Name 之所以有值,是因為它是公開屬性而非那個 private string name 欄位。
用 using 取代手動 Close。範例為了清楚起見寫了 stream.Close(),實務上建議改用 using 區塊,避免中途拋例外時串流沒有釋放。