C# 如何将复杂的嵌套对象序列化为xml

使用XmlSerializer可将C#复杂嵌套对象序列化为XML,需确保类有默认构造函数且属性公开;通过特性如[XmlElement]、[XmlArray]等可自定义元素名称和结构;支持嵌套对象与数组,但不支持泛型接口和字段,需避免循环引用。

在 C# 中将复杂的嵌套对象序列化为 XML,最常用的方式是使用 XmlSerializer 类。只要类和属性正确标注了可序列化的结构,即使是多层嵌套的对象也能顺利转换为 XML。

1. 确保类具有默认构造函数并公开属性

XmlSerializer 要求被序列化的类必须有一个无参数的公共构造函数,并且只有 public 的读写属性(Property)才会被序列化。

例如,定义一个包含嵌套对象的学生信息类:

using System;
using System.Xml.Serialization;

[Serializable]
public class Student
{
    public string Name { get; set; }
    public int Age { get; set; }

    // 嵌套对象
    public Address HomeAddress { get; set; }

    // 集合类型的嵌套
    public Course[] Courses { get; set; }
}

public class Address
{
    public string Street { get; set; }
    public string City { get; set; }
    public string ZipCode { get; set; }
}

public class Course
{
    public string Title { get; set; }
    public int Credits { get; set; }
}

2. 使用 XmlSerializer 进行序列化

创建 XmlSerializer 实例,调用 Serialize 方法将对象写入 XML 流。
using System;
using System.IO;
using System.Xml;

// 创建学生对象
var student = new Student
{
    Name = "张三",
    Age = 20,
    HomeAddress = new Address
    {
        Street = "中山路123号",
        City = "北京",
        ZipCode = "100000"
    },
    Courses = new Course[]
    {
        new Course { Title = "数学", Credits = 4 },
        new Course { Title = "英语", Credits = 3 }
    }
};

// 序列化为 XML
var serializer = new XmlSerializer(typeof(Student));
using (var writer = XmlWriter.Create("student.xml", new XmlWriterSettings
{
    Indent = true
}))
{
    serializer.Serialize(writer, student);
}

生成的 XML 类似如下:


  张三
  20
  
    中山路123号
    北京
    100000
  
  
    
      数学
      4
    
    
      英语
      3
    
  

3. 自定义 XML 输出格式(可选)

你可以通过特性控制元素名称、是否省略命名空间等。
[XmlRoot("Person")]
public class Student
{
    [XmlElement("StudentName")]
    public string Name { get; set; }

    [XmlElement("Residence")]
    public Address HomeAddress { get; set; }

    [XmlArray("EnrolledCourses")]
    [XmlArrayItem("CourseItem")]
    public Course[] Courses { get; set; }
}

这样输出会变成:


  张三
  
    中山路123号
    北京
    100000
  
  
    
      数学
      4
    
    
      英语
      3
    
  

4. 注意事项与限制

虽然 XmlSerializer 功能强大,但有一些细节需要注意:
  • 不支持泛型集合接口(如 IList),建议使用数组或 List
  • 字段(Field)不会被自动序列化,除非加上 [XmlElement]
  • 构造函数在反序列化时不会完全按预期执行,避免在构造中做复杂初始化
  • 如果类中有循环引用(比如 A 包含 B,B 又引用 A),会抛出异常,需手动处理

基本上就这些。只要结构清晰、属性公开、嵌套对象也符合序列化要求,C# 的 XmlSerializer 就能很好地处理复杂对象转 XML。