C# XmlSerializer如何处理继承类的序列化

来源:这里教程网 时间:2026-02-21 17:28:53 作者:

在使用 C# 的 XmlSerializer 处理继承类时,不能直接序列化派生类对象到基类引用,除非显式告知序列化器可能的子类型。这是因为 XmlSerializer 是静态类型的,它需要在构造时就知道所有可能参与序列化的类型。

问题场景

假设你有如下类结构:

public class Animal
{
    public string Name { get; set; }
}

public class Dog : Animal
{
    public string Breed { get; set; }
}

当你尝试序列化一个 Dog 对象赋值给 Animal 变量时,会出错或丢失派生成员:

Animal animal = new Dog { Name = "Buddy", Breed = "Golden Retriever" };
var serializer = new XmlSerializer(typeof(Animal));
// 抛出异常:未将类型“Dog”注册

解决方案:使用 XmlInclude 特性

最常用的方式是在基类上使用 [XmlInclude] 特性,提前注册所有可能的派生类。

[XmlInclude(typeof(Dog))]
public class Animal
{
    public string Name { get; set; }
}

public class Dog : Animal
{
    public string Breed { get; set; }
}

现在可以正确序列化:

Animal animal = new Dog { Name = "Buddy", Breed = "Golden Retriever" };
var serializer = new XmlSerializer(typeof(Animal));
using var writer = new StringWriter();
serializer.Serialize(writer, animal);
Console.WriteLine(writer.ToString());

输出中会包含 xsi:type="Dog" 来标识实际类型:


  Buddy
  Golden Retriever

多个派生类的处理

如果有多个子类,可以在基类上添加多个 XmlInclude

[XmlInclude(typeof(Dog))]
[XmlInclude(typeof(Cat))]
[XmlInclude(typeof(Bird))]
public class Animal
{
    public string Name { get; set; }
}

public class Cat : Animal
{
    public bool IsIndoor { get; set; }
}

运行时指定类型(高级用法)

如果无法修改基类代码,可以在创建 XmlSerializer 时传入额外的类型数组:

Type[] derivedTypes = new Type[] { typeof(Dog), typeof(Cat) };
var serializer = new XmlSerializer(typeof(Animal), derivedTypes);

这种方式适合插件式架构或动态加载类型的情况。

基本上就这些。只要确保派生类型被注册,XmlSerializer 就能正确处理继承关系的序列化和反序列化。不复杂但容易忽略。

相关推荐