通八洲科技

C# XmlSerializer的已知类型(Known Types)怎么用

日期:2025-12-21 00:00 / 作者:幻夢星雲
XmlSerializer需通过构造函数传入派生类型数组来支持多态,因它不支持[KnownType];若字段声明为基类但实际为子类实例,不指定已知类型将导致反序列化失败。

XmlSerializer 本身不支持直接通过属性或参数声明“已知类型”——它不像 DataContractSerializer 那样有 [KnownType] 特性。但你仍可以通过构造函数传入类型数组,让 XmlSerializer 在序列化/反序列化时识别派生类。

为什么需要“已知类型”

当你序列化的对象包含多态字段(比如基类类型字段实际引用了子类实例),XmlSerializer 默认只认字段声明的类型,无法自动识别运行时的真实子类。不告诉它子类类型,反序列化会失败或丢失数据。

用构造函数传入 Type[] 告诉它有哪些可能的子类

关键是在创建 XmlSerializer 实例时,把所有可能出现在 XML 中的**派生类型**(包括间接继承的)显式传进去:

代码示例:正确使用已知类型

假设有以下类结构:

public class Animal { public string Name { get; set; } }
public class Dog : Animal { public string Breed { get; set; } }
public class Cat : Animal { public bool IsIndoor { get; set; } }

public class Zoo
{
    public Animal Resident { get; set; }
}

序列化 Dog 实例时需这样创建 XmlSerializer

var zoo = new Zoo { Resident = new Dog { Name = "Buddy", Breed = "Golden" } };
// 显式告知:Resident 可能是 Dog 或 Cat
var serializer = new XmlSerializer(typeof(Zoo), 
    new[] { typeof(Dog), typeof(Cat) });

using (var writer = new StringWriter())
{
    serializer.Serialize(writer, zoo);
    // 输出 XML 包含 xsi:type="Dog",可被正确反序列化
}

反序列化同理,必须用**完全相同的已知类型数组**初始化 XmlSerializer,否则遇到 xsi:type="Dog" 会报错。

常见误区和注意点