C#中将对象数组序列化为XML 常见配置与错误排查-C#.Net教程-PHP中文网

C#中将对象数组序列化为XML 常见配置与错误排查

小老鼠

发布： 2025-11-30 15:07:35

原创

678人浏览过

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

c#中将对象数组序列化为xml 常见配置与错误排查

在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更简洁。

猫眼课题宝

5分钟定创新选题，3步生成高质量标书！

262

查看详情

常见错误与排查

实际使用中常遇到以下问题：

InvalidOperationException: 类型 XXX 不可被序列化：检查类是否缺少 public 无参构造函数，或包含不可序列化的字段（如 delegate、IntPtr）
空值未输出或格式异常：使用 [XmlElement(IsNullable = true)] 明确支持 null 值输出为 xsi:nil="true"
只读集合无法反序列化：XmlSerializer 要求集合属性有可访问的 setter
中文乱码：写入文件时指定编码，如 new StreamWriter("file.xml", false, Encoding.UTF8)
性能问题：首次序列化会生成临时程序集，可使用 Sgen.exe 预生成序列化程序集提升性能