C#如何将List对象序列化为XML

大辰同学_7992

大辰同学_7992

2026-01-03

660人浏览

原创

XmlSerializer序列化List需T为public类、含无参构造函数及public读写属性;须传typeof(List),支持Xml特性定制根名与命名空间,不支持私有字段、只读属性、Dictionary等。

c#如何将list对象序列化为xml

用 XmlSerializer 序列化 List 是最直接的方式

只要类型 T 是公共类、有无参构造函数、所有要序列化的字段/属性是公共的,XmlSerializer 就能正常工作。它不支持私有字段、只读属性(除非有 public setter)、Dictionary 或匿名类型。

常见错误现象:InvalidOperationException 提示“无法序列化类型 System.Collections.Generic.List`1”,通常是因为没传入泛型类型的具体类型信息,或目标类里有不可序列化的成员。

  • 必须显式传入 typeof(List) 构造 XmlSerializer,不能只传 typeof(T)
  • 如果 T 有自定义属性(如 [XmlIgnore]、[XmlElement("Name")]),它们会生效
  • 序列化结果中默认根元素名是 ArrayOfType,可通过包装类或 XmlRoot 特性控制
var list = new List<person>
{
    new Person { Name = "Alice", Age = 30 },
    new Person { Name = "Bob", Age = 25 }
};

var serializer = new XmlSerializer(typeof(List<person>));
using (var writer = new StringWriter())
{
    serializer.Serialize(writer, list);
    Console.WriteLine(writer.ToString());
}</person></person>

Person 类必须满足基本可序列化要求

XmlSerializer 不会报错但静默跳过不可序列化成员,比如没有 getter/setter 的属性、internal 或 private 字段、static 成员。务必检查生成的 XML 是否包含预期字段。

容易踩的坑:忘记加无参构造函数,或把属性写成 public string Name { get; }(只读)——这会导致该字段不出现在 XML 中。

  • 类必须是 public
  • 每个要序列化的属性必须有 public getter 和 setter
  • 必须有 public 无参构造函数(编译器自动生成的也行)
  • 避免在属性 getter 中抛异常或访问外部资源
public class Person
{
    public Person() { } // 必须存在

    public string Name { get; set; } // ✅ 可序列化
    public int Age { get; set; }     // ✅ 可序列化
    public string InternalId { get; private set; } // ❌ 不会出现在 XML 中
}

想自定义根节点名或去掉默认命名空间?用 XmlRoot 和 XmlSerializerNamespaces

默认输出带 xmlns:xsi 和 xmlns:xsd,多数场景不需要。根元素叫 ArrayOfPerson 也不够直观。这两个问题可以一起解决。

Expanso json-flatten
Expanso json-flatten

通过 CLI 或 MCP 服务器,使用 Expanso Edge 管道扁平化嵌套 JSON 对象。

下载

注意:XmlRoot 特性只能加在类上,对 List 本身无效;所以更稳妥的做法是封装一层容器类,或者用 XmlSerializer 构造时传入 XmlRootAttribute 实例。

  • 传入 new XmlRootAttribute("People") 可改根名
  • 用 XmlSerializerNamespaces 添加空前缀可移除默认命名空间
  • 若用容器类(如 PeopleCollection),直接在类上加 [XmlRoot("People")] 更清晰
var serializer = new XmlSerializer(
    typeof(List<person>),
    new XmlRootAttribute("People"));

var ns = new XmlSerializerNamespaces();
ns.Add("", ""); // 移除默认命名空间

using (var writer = new StringWriter())
{
    serializer.Serialize(writer, list, ns);
    Console.WriteLine(writer.ToString());
}</person>

别用 DataContractSerializer 替代,除非你已绑定 WCF 场景

DataContractSerializer 默认不支持 List 直接序列化,且需要显式标记 [DataContract] 和 [DataMember],XML 格式也不同(带 xmlns:i 等)。它更适合服务间契约明确的场景,不是通用 XML 生成方案。

如果你只是导出配置、日志或简单数据交换,坚持用 XmlSerializer。混用两种序列化器容易导致反序列化失败或字段丢失。

  • XmlSerializer 基于公有成员,约定优先,适合人读 XML
  • DataContractSerializer 基于显式契约,适合跨平台服务通信
  • 二者生成的 XML 结构、命名空间、空值处理逻辑都不同,不能互换

真正麻烦的点在于:一旦 T 类型嵌套了其他泛型集合、接口类型或含循环引用,XmlSerializer 会直接失败,而且错误信息非常模糊。这种时候要么重构模型,要么换 JSON。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

js json c#

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2215

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3502

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1176

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

4039

7

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.02

6859

3

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.01

4804

5

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2024.08.01

6237

7

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

2024.11.28

2542

7

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

2023.10.19

3188

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 21.2万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.9万人学习