.NET的System.Xml.Serialization命名空间有哪些常用类

10次阅读

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

.NET的System.Xml.Serialization命名空间有哪些常用类

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 + 特性组合已覆盖绝大多数需求;XmlSerializerNamespacesXmlAttributeOverrides 属于进阶但实用的补充。注意它不适用于流式大 XML 或需要 XPath/XSLT 的场景——那种更适合 XmlReader/XmlWriterXDocument

text=ZqhQzanResources