System.Xml.Serialization 命名空间提供基于类结构的 XML 序列化核心支持,以 XmlSerializer 为主力,配合 XmlSerializerNamespaces 控制命名空间、XmlAttributeOverrides 实现运行时动态覆盖,并通过 XmlElement 等特性精细定制序列化行为。

System.Xml.Serialization 命名空间是 .NET 中用于将对象与 XML 之间进行序列化和反序列化的核心组件,特别适合处理基于类结构的 XML 数据(如配置、简单数据交换)。它不依赖 XSD 或复杂模式,上手快、控制力强,但对 XML 结构灵活性要求较高。
XmlSerializer — 最常用的核心类
这是整个命名空间的“主力”,负责把对象转成 XML(序列化)或把 XML 解析为对象(反序列化)。
- 构造时通常传入目标类型:
new XmlSerializer(typeof(Person)) - 支持 public 字段和属性(需有 get/set),不支持 private 字段(除非用
[XmlIgnore]或[XmlElement]等特性控制) - 默认按属性名生成 XML 元素名,可用
[XmlElement("Name")]自定义 - 常见用法:
serializer.Serialize(writer, obj)和serializer.Deserialize(reader)
XmlSerializerNamespaces — 控制命名空间声明
当需要生成带 xmlns 声明的 XML(比如符合某 SOAP 或标准格式),就靠它。
- 用
Add("prefix", "uri")添加命名空间前缀映射 - 传给
Serialize()方法的重载版本,避免默认生成冗余的xmlns:xsi等 - 例如:
ns.Add("ns", "http://example.com/schema"); serializer.Serialize(writer, obj, ns);
XmlAttributeOverrides — 运行时动态覆盖序列化行为
适合同一类型在不同场景下需要不同 XML 表现(比如部分字段只在导出时出现)。
- 先创建
XmlAttributeOverrides实例 - 用
Add(type, memberName, attrs)指定某属性/字段要应用哪些新特性(如new XmlElementAttribute("Alias")) - 构造
XmlSerializer时传入该 overrides 对象 - 比硬编码特性更灵活,适合插件式或配置驱动的序列化逻辑
辅助特性类(非独立使用,但高频配合 XmlSerializer)
这些不是“工具类”,而是打在类成员上的特性,直接决定 XML 输出形态:
-
[XmlElement]:把属性序列化为 XML 元素(默认行为,可省略;加了可改名称、顺序、是否必需等) -
[XmlAttribute]:序列化为 XML 属性而非元素(如) -
[XmlArray]和[XmlArrayItem]:控制集合类型(如List)的包装元素和子项名称 -
[XmlIgnore]:跳过某个字段或属性,不参与序列化 -
[XmlRoot]:修饰类本身,定义根元素名称、命名空间、是否为空等
基本上就这些。日常开发中,XmlSerializer + 特性组合已覆盖绝大多数需求;XmlSerializerNamespaces 和 XmlAttributeOverrides 属于进阶但实用的补充。注意它不适用于流式大 XML 或需要 XPath/XSLT 的场景——那种更适合 XmlReader/XmlWriter 或 XDocument。










