使用XmlInclude特性或传入派生类型数组可解决C# XmlSerializer无法直接序列化继承类的问题,需在序列化前注册所有可能的子类型。

在使用 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" 来标识实际类型:
多个派生类的处理
如果有多个子类,可以在基类上添加多个 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 就能正确处理继承关系的序列化和反序列化。不复杂但容易忽略。







