C#怎么把一个DataTable对象保存为XML文件

把DataTable保存为XML文件是C#开发中经常遇到的需求，比如做数据导出、配置持久化或者跨平台数据交换。DataTable类本身就提供了WriteXml方法，调用起来非常简单，但如果不了解它的参数和行为，很容易写出带有冗余信息或者格式不符合预期的XML。这篇文章从几种常见的保存场景出发，逐步说明如何正确、高效地完成DataTable到XML的转换。

使用DataTable.WriteXml直接保存到文件

最基础的做法是调用DataTable的WriteXml方法，并把文件路径作为参数传入。这个方法会把整个表的数据按照默认格式序列化成XML文档。下面是一个完整的示例：先创建一个DataTable，添加两列和三行数据，然后写入到本地的table.xml文件。

// 创建DataTable并添加数据
DataTable dt = new DataTable("Employee");
dt.Columns.Add("Id", typeof(int));
dt.Columns.Add("Name", typeof(string));
dt.Columns.Add("Salary", typeof(decimal));

dt.Rows.Add(1, "张三", 8500.50m);
dt.Rows.Add(2, "李四", 9200.00m);
dt.Rows.Add(3, "王五", 7800.75m);

// 直接写入文件，默认不包含Schema
dt.WriteXml("table.xml");

执行这段代码后，生成的table.xml内容大致如下：根元素是我们在构造函数中指定的表名Employee，每一行数据对应一个Employee节点，列名作为子元素名称。需要注意的是，默认情况下WriteXml不会写入表结构信息，也就是说不包含数据类型、约束等元数据。如果后续需要从XML恢复成DataTable，必须手动指定结构，否则会丢失类型信息，所有值都会变成字符串。

如果希望生成的XML自动带上架构信息，可以使用另一个重载，指定XmlWriteMode为WriteSchema。这样生成的XML会包含一个内嵌的XSD架构，同时数据节点也会带有命名空间前缀。这种方式适合需要长期存储、之后还要原样恢复的场景，但文件体积会明显变大。

控制XML格式：XmlWriteMode.WriteSchema与IgnoreSchema

WriteXml方法有一个可选参数xmlWriteMode，它是一个XmlWriteMode枚举，常用的值有两个：IgnoreSchema（默认）和WriteSchema。IgnoreSchema只写数据，不写结构；WriteSchema会先把表结构以XSD的形式写入文件，然后紧跟数据。下面这个例子展示了如何写入带Schema的XML。

// 写入带Schema的XML
dt.WriteXml("table_with_schema.xml", XmlWriteMode.WriteSchema);

打开table_with_schema.xml，你会看到类似这样的结构：在根元素之前有一段xs:schema定义，描述了Employee表的列名、类型以及是否允许为空。数据部分仍然在Employee元素下，但每个节点的命名空间会带有默认的XSD前缀。这种格式的好处是ReadXml时可以自动还原列类型，例如Id会被识别为Int32而不是字符串。但代价是文件体积增加，而且如果XML是提供给其他系统使用，对方可能需要忽略这些额外的命名空间信息。

IgnoreSchema模式生成的文件非常干净，适合纯数据交换场景。不过需要注意的是，即使使用IgnoreSchema，DataTable内部也会保留一些默认行为，比如空值列会生成带有xsi:nil="true"属性的节点，除非你手动配置列的AllowDBNull为false并且赋了默认值。如果希望完全控制输出格式，可以改用XmlWriter配合WriteXml的重载。

使用XmlWriter自定义XML输出

当默认的WriteXml行为不能满足需求时，比如要去掉命名空间、调整缩进格式、或者把XML写入内存流而不是直接落盘，可以创建一个XmlWriter实例，然后调用WriteXml的重载版本。下面的代码演示了如何去掉XML声明中的编码信息，并设置缩进为两个空格，最后输出到一个StringBuilder以便后续处理。

using System.Text;
using System.Xml;

// 准备DataTable（省略创建和填充代码，此处使用前面示例中的dt）

StringBuilder sb = new StringBuilder();
XmlWriterSettings settings = new XmlWriterSettings
{
    Indent = true,
    IndentChars = "  ",
    OmitXmlDeclaration = true, // 省略XML声明
    Encoding = Encoding.UTF8
};

using (XmlWriter writer = XmlWriter.Create(sb, settings))
{
    dt.WriteXml(writer, XmlWriteMode.IgnoreSchema);
}

string xmlContent = sb.ToString();
Console.WriteLine(xmlContent);

这种方式非常灵活，你可以通过XmlWriterSettings设置是否换行、缩进字符、是否写XML声明、编码格式等等。比如很多外部系统要求不带任何命名空间，而DataTable默认生成的XML根元素会带有xmlns属性，这时就可以在写入后通过字符串替换去掉，或者更优雅的方式是自己用XmlWriter遍历DataTable手动写节点，但这会复杂很多。通常情况下，使用WriteXml配合XmlWriterSettings已经能满足90%的需求。

另外，如果你只是想把XML写到内存里而不生成文件，可以直接使用MemoryStream或者StringWriter。比如通过MemoryStream获取字节数组，方便在Web API中直接返回文件流。

从XML恢复DataTable：ReadXml方法

保存为XML之后，自然也需要读取回来。DataTable提供了ReadXml方法，可以读取XML文件或流，并自动填充数据。读取时同样需要决定是否依赖XML中的Schema。如果XML文件是用WriteSchema生成的，直接调用ReadXml就能还原出带有正确列类型的DataTable。

// 从带Schema的XML读取
DataTable dtFromXml = new DataTable();
dtFromXml.ReadXml("table_with_schema.xml");

Console.WriteLine(dtFromXml.Columns["Id"].DataType); // 输出 System.Int32

但如果读取的是IgnoreSchema生成的XML，ReadXml会把所有列都识别为字符串类型，而且RequiresPrimaryKey等约束也会丢失。此时需要在读取前手动定义好DataTable的结构，然后使用ReadXml的重载，传入XmlReadMode.IgnoreSchema，让数据按照现有结构填充。

// 事先定义结构
DataTable dtNoSchema = new DataTable("Employee");
dtNoSchema.Columns.Add("Id", typeof(int));
dtNoSchema.Columns.Add("Name", typeof(string));
dtNoSchema.Columns.Add("Salary", typeof(decimal));

dtNoSchema.ReadXml("table.xml", XmlReadMode.IgnoreSchema);

这种方式需要开发人员明确知道XML的结构，但好处是文件体积小、传输效率高。实际项目中常见的做法是：如果数据只在本系统内使用，直接存成带Schema的XML；如果数据要发给第三方，则存成不带Schema的纯数据XML，由接收方根据约定定义结构。

还有一个容易忽略的点是，ReadXml在遇到XML中不存在的列时会忽略它们，如果XML中有额外的元素而DataTable没有对应列，默认会被跳过，不会报错。这在处理版本兼容时很有用。

大数据量场景下的性能与注意事项

当DataTable包含几十万行甚至更多数据时，直接调用WriteXml("file.xml")会一次性生成完整的XML文档，占用大量内存，可能导致内存溢出或者长时间阻塞。这种情况建议使用XmlWriter直接流式写入文件，避免同时在内存中构建完整的XML字符串。DataTable的WriteXml重载可以接受XmlWriter，而XmlWriter可以绑定到FileStream，实现边写边释放。

using (FileStream fs = new FileStream("large_table.xml", FileMode.Create))
using (XmlWriter writer = XmlWriter.Create(fs, new XmlWriterSettings { Indent = false }))
{
    // 注意：这里仍然是整个DataTable一次性枚举，但不会在内存中拼接整个XML
    dt.WriteXml(writer, XmlWriteMode.IgnoreSchema);
}

需要注意的是，即使使用XmlWriter，DataTable.WriteXml内部仍然会把所有行枚举一遍，但它不会在内存中维护整个XML字符串，而是逐段写入流，因此内存占用会低很多。如果要进一步优化，可以考虑分批从数据库读取数据，逐批填充DataTable并写入XML，但这超出了本文的讨论范围。

另一个常见问题是特殊字符的处理。DataTable中的字符串可能包含<、>、&等XML特殊字符，WriteXml会自动进行转义，因此不需要开发者手动处理。但是如果你使用了手动拼接XML字符串的方式，就必须自己负责转义，否则生成的XML无法解析。

编码方面，默认WriteXml写入文件时使用UTF-8无BOM编码。如果需要指定其他编码（例如GB2312），最好使用XmlWriter并设置Encoding属性，或者写入后重新读取并转换编码。不过大多数现代系统都支持UTF-8，建议保持默认即可。

总之，把DataTable保存为XML在C#中是一件非常顺手的事情，关键是根据实际场景选择合适的保存方式：简单文件存储用WriteXml加文件名；需要保留结构用WriteSchema；需要自定义格式或写入内存用XmlWriter；读取时根据XML是否带Schema选择相应的ReadXml模式。掌握这些细节，就能在数据持久化和交换中游刃有余。

C# DataTableXML文件WriteXml修改时间：2026-10-06 22:08:59