使用XmlSerializer可将C#对象数组序列化为XML,需确保类有公共无参构造函数、属性公开并正确应用[Serializable]、[XmlRoot]等特性;通过XmlSerializerNamespaces移除默认命名空间可优化输出;常见问题包括类型不可序列化、空值处理异常、中文乱码等,应检查构造函数、setter访问性及编码设置;泛型或接口成员建议封装为具体类或改用DataContractSerializer;调试时先序列化单个对象并结合MemoryStream验证输出。

在C#中将对象数组序列化为XML是常见需求,尤其在配置文件处理、数据交换等场景中。使用 XmlSerializer 可以轻松实现,但若配置不当或类型不兼容,容易出现异常或输出不符合预期。以下是常见配置方式与典型错误排查方法。
基本序列化配置
要将对象数组正确序列化为XML,需确保类和成员具备可序列化特性:
- 目标类必须有公共无参构造函数
- 所有需要序列化的字段或属性应为 public,且提供 get/set 访问器
- 使用 [Serializable] 特性标记类(非必需,但建议)
- 数组或集合成员可用 [XmlElement] 或 [XmlArray] 控制输出结构
[Serializable]
public class Person
{
public string Name { get; set; }
public int Age { get; set; }
}
// 序列化对象数组
Person[] people = new Person[]
{
new Person { Name = "Alice", Age = 30 },
new Person { Name = "Bob", Age = 25 }
};
XmlSerializer serializer = new XmlSerializer(typeof(Person[]));
using (TextWriter writer = new StreamWriter("people.xml"))
{
serializer.Serialize(writer, people);
}
生成的XML会包含根元素“ArrayOfPerson”,每个项为“Person”节点。
控制XML输出结构
默认命名可能不够直观,可通过特性自定义标签名:
- 使用 [XmlRoot("People")] 修饰数组类型或包装类,设置根节点名称
- 用 [XmlElement("Person")] 指定数组元素的标签名
- 避免生成 xmlns:xsi 和 xsi:type 属性,可在 Serialize 时传入 XmlSerializerNamespaces
var ns = new XmlSerializerNamespaces();
ns.Add("", ""); // 移除默认命名空间
serializer.Serialize(writer, people, ns);
这样可避免生成冗余的命名空间声明,使XML更简洁。
常见错误与排查
实际使用中常遇到以下问题:
- InvalidOperationException: 类型 XXX 不可被序列化:检查类是否缺少 public 无参构造函数,或包含不可序列化的字段(如 delegate、IntPtr)
- 空值未输出或格式异常:使用 [XmlElement(IsNullable = true)] 明确支持 null 值输出为 xsi:nil="true"
- 只读集合无法反序列化:XmlSerializer 要求集合属性有可访问的 setter
- 中文乱码:写入文件时指定编码,如 new StreamWriter("file.xml", false, Encoding.UTF8)
- 性能问题:首次序列化会生成临时程序集,可使用 Sgen.exe 预生成序列化程序集提升性能
若类型包含泛型、接口或抽象成员,XmlSerializer 可能无法直接处理,建议封装为具体类数组或使用 DataContractSerializer 替代。
调试建议
- 先尝试序列化单个对象,确认基础结构正确
- 使用 MemoryStream + Console.WriteLine 输出中间结果,便于查看生成内容
- 启用调试编译,捕获详细的异常堆栈信息
- 检查生成的XML是否符合XSD预期,必要时手动编写样例对比
基本上就这些。只要类型结构清晰、配置合理,C#的XML序列化稳定可靠。关键是注意构造函数、访问级别和特性标注细节,避免运行时失败。










