C#如何将Dictionary序列化为XML

在C#开发里，Dictionary是最常用的键值集合之一，但不少人在做数据持久化或接口通信时，希望把它直接变成XML格式。与JSON不同，.NET自带的XmlSerializer并不会天然支持Dictionary的序列化，这就需要开发者理解背后的限制并采用合适的方案。

为什么XmlSerializer不能直接序列化Dictionary

XmlSerializer要求被序列化的类型具备无参构造函数，并且对集合类型要求实现特定模式，例如要有索引器、Add方法以及公开的强类型子元素。Dictionary虽然实现了IDictionary，但它没有供XmlSerializer识别的无参索引器结构，因此在运行时会抛出类似“不支持的类型”的异常。

从设计角度看，XML是一种强调节点名称和层级结构的数据格式，而Dictionary的键可以是任意对象，无法稳定映射为合法的XML元素名。这也是框架默认拒绝直接序列化的原因。如果强行使用二进制格式化或DataContractSerializer，虽然能写出内容，但生成的XML往往带有大量专用命名空间，不适合跨平台读取。

方案一一使用自定义包装类配合XmlSerializer

最常见且安全的做法是定义一个简单的键值对包装类，将Dictionary转换成List后再序列化。这样既能利用XmlSerializer的稳定性，也能在反序列化时原样还原。

下面给出一个完整的示例，其中Item类保存键和值，DictContainer类持有Item列表，并在转换方法中完成Dictionary与列表的互转。

using System;
using System.Collections.Generic;
using System.Xml.Serialization;

[XmlRoot("Dictionary")]
public class DictContainer
{
    [XmlElement("Item")]
    public List<Item> Items { get; set; }

    public DictContainer() { }

    public DictContainer(Dictionary<string, string> dict)
    {
        Items = new List<Item>();
        foreach (var kv in dict)
        {
            Items.Add(new Item { Key = kv.Key, Value = kv.Value });
        }
    }

    public Dictionary<string, string> ToDictionary()
    {
        var result = new Dictionary<string, string>();
        if (Items != null)
        {
            foreach (var item in Items)
            {
                result[item.Key] = item.Value;
            }
        }
        return result;
    }
}

public class Item
{
    [XmlAttribute("key")]
    public string Key { get; set; }

    [XmlText]
    public string Value { get; set; }
}

class Program
{
    static void Main()
    {
        var dict = new Dictionary<string, string>
        {
            { "name", "张三" },
            { "role", "admin" }
        };

        var container = new DictContainer(dict);
        var serializer = new XmlSerializer(typeof(DictContainer));
        using (var writer = new System.IO.StreamWriter("output.xml"))
        {
            serializer.Serialize(writer, container);
        }

        DictContainer loaded;
        using (var reader = new System.IO.StreamReader("output.xml"))
        {
            loaded = (DictContainer)serializer.Deserialize(reader);
        }

        var back = loaded.ToDictionary();
        Console.WriteLine(back["name"]);
    }
}

上述代码把每个字典项写成一个带有key属性和文本值的Item节点。这样做生成的XML可读性很好，也能被其他语言轻松解析。缺点是如果值是复杂对象，需要在Item里进一步定义子结构。

这种方式的优点在于完全基于标准XmlSerializer，不需要引入第三方库，反序列化逻辑清晰。缺点是要写额外的包装类型，当字典嵌套或值类型多变时会稍微繁琐。

方案二使用LINQ to XML手动构造

如果希望更灵活地控制XML形态，比如自定义根节点名称、添加命名空间或把键作为元素名，可以使用XElement来手动构建。这个方法不依赖序列化器的反射规则，适合动态结构。

以下示例演示如何把一个字符串字典转换为带有自定义节点名称的XML字符串。

using System;
using System.Collections.Generic;
using System.Xml.Linq;

class LinqToXmlDemo
{
    static string DictToXml(Dictionary<string, int> dict)
    {
        var root = new XElement("Config",
            new XAttribute("version", "1.0"));
        foreach (var kv in dict)
        {
            root.Add(new XElement(kv.Key, kv.Value));
        }
        return root.ToString();
    }

    static void Run()
    {
        var data = new Dictionary<string, int>
        {
            { "timeout", 30 },
            { "retry", 3 }
        };
        string xml = DictToXml(data);
        Console.WriteLine(xml);
    }
}

这段代码把键直接作为子元素名，值作为元素内容。当键是合法XML名称时非常直观，但如果键里含有空格或特殊字符，就需要先做清洗或改用属性存储。

LINQ to XML方案的强项是轻量和可控，不需要定义额外类，也方便在运行时拼装。不足之处是缺少强类型的往返序列化，反序列化时要自己写解析代码，容易在字段变更时引入错误。

复杂值类型的处理建议

当Dictionary的值不是基础类型，而是自定义类时，无论用哪种方案都要确保该类可序列化。若使用包装类方案，可以把值也定义为可序列化的子对象；若使用LINQ to XML，则需要自己调用Json.NET或手动展开属性。

此外，如果键本身不是字符串，应先统一转换为字符串形式，避免XML节点命名非法。对于需要跨服务传输的场景，推荐在内部统一采用包装类加XmlSerializer，既保证结构稳定，也方便后期维护。

总结对比

下表列出两种常用方式的差异，方便在实际项目中权衡。

根据项目对稳定性和灵活性的要求，选择对应方案即可。理解Dictionary不能直接被XmlSerializer支持的原因，是避免踩坑的第一步。

C#DictionaryXML_serialization修改时间：2026-08-09 04:06:33