C#怎么将XML反序列化为对象

在C#开发中，XML是一种常见的数据交换格式，将XML字符串或文件内容反序列化为对应的实体对象，能够大幅简化数据解析的流程，避免手动解析XML节点的繁琐操作。实现这个功能主要依赖.NET框架自带的XmlSerializer类，下面详细介绍具体的实现方法。

定义匹配的实体类

反序列化的第一步是定义和XML结构完全匹配的实体类，需要给类添加Serializable特性，同时根据XML的节点层级和属性，使用对应的特性标注类的属性和字段。

假设我们有如下格式的XML数据：

<?xml version="1.0" encoding="utf-8"?>
<User>
  <Id>1001</Id>
  <Name>张三</Name>
  <Age>25</Age>
  <Email>test@ipipp.com</Email>
</User>

对应的实体类定义如下：

using System;
using System.Xml.Serialization;

// 标注类可序列化，根节点名称为User
[XmlRoot("User")]
[Serializable]
public class User
{
    // 对应XML中的Id节点
    [XmlElement("Id")]
    public int Id { get; set; }

    // 对应XML中的Name节点
    [XmlElement("Name")]
    public string Name { get; set; }

    // 对应XML中的Age节点
    [XmlElement("Age")]
    public int Age { get; set; }

    // 对应XML中的Email节点
    [XmlElement("Email")]
    public string Email { get; set; }
}

核心反序列化实现

XmlSerializer类提供了反序列化的核心能力，我们可以通过字符串流或者文件流来完成反序列化操作，下面分别给出两种场景的实现代码。

从XML字符串反序列化

如果XML数据是以字符串形式存在，可以使用StringReader来读取内容，再调用XmlSerializer的Deserialize方法：

using System;
using System.IO;
using System.Xml.Serialization;

public class XmlHelper
{
    public static T DeserializeFromXmlString<T>(string xmlString)
    {
        // 创建XmlSerializer实例，指定目标类型
        XmlSerializer serializer = new XmlSerializer(typeof(T));
        // 使用StringReader读取XML字符串
        using (StringReader reader = new StringReader(xmlString))
        {
            // 执行反序列化操作，返回目标类型对象
            return (T)serializer.Deserialize(reader);
        }
    }
}

// 调用示例
class Program
{
    static void Main(string[] args)
    {
        string xmlStr = @"<?xml version=""1.0"" encoding=""utf-8""?>
<User>
  <Id>1001</Id>
  <Name>张三</Name>
  <Age>25</Age>
  <Email>test@ipipp.com</Email>
</User>";
        User user = XmlHelper.DeserializeFromXmlString<User>(xmlStr);
        Console.WriteLine($"用户ID：{user.Id}，姓名：{user.Name}，年龄：{user.Age}，邮箱：{user.Email}");
    }
}

从XML文件反序列化

如果XML数据存储在本地文件中，可以使用FileStream来读取文件内容：

using System;
using System.IO;
using System.Xml.Serialization;

public class XmlHelper
{
    public static T DeserializeFromXmlFile<T>(string filePath)
    {
        XmlSerializer serializer = new XmlSerializer(typeof(T));
        // 使用FileStream读取XML文件
        using (FileStream stream = new FileStream(filePath, FileMode.Open))
        {
            return (T)serializer.Deserialize(stream);
        }
    }
}

// 调用示例，假设文件存放在D盘根目录的user.xml
class Program
{
    static void Main(string[] args)
    {
        string filePath = @"D:user.xml";
        User user = XmlHelper.DeserializeFromXmlFile<User>(filePath);
        Console.WriteLine($"用户ID：{user.Id}，姓名：{user.Name}，年龄：{user.Age}，邮箱：{user.Email}");
    }
}

常见问题及解决方案

• 命名空间不匹配：如果XML根节点带有命名空间，需要在XmlRoot特性中指定命名空间，例如[XmlRoot("User", Namespace = "http://tempuri.org/")]
• 节点名称大小写不一致：XML节点名称默认区分大小写，如果实体类属性名和XML节点名大小写不同，需要通过XmlElement特性的ElementName参数指定匹配的节点名
• XML包含数组或列表数据：如果XML中有重复的同级节点，实体类中可以用List<T>类型的属性接收，同时添加[XmlArray("父节点名")]和[XmlArrayItem("子节点名")]特性标注
• 反序列化失败报错：可以先检查XML格式是否正确，再核对实体类的特性和XML结构是否完全匹配，也可以捕获InvalidOperationException异常查看具体的错误信息

注意事项

使用XmlSerializer时需要注意，实体类的属性必须是可访问的，私有属性无法被反序列化赋值。另外XmlSerializer会生成临时程序集，如果在频繁调用的场景中使用，建议将XmlSerializer实例缓存起来，避免重复创建带来的性能损耗。

C#XML反序列化对象序列化XmlSerializer数据转换修改时间：2026-07-04 11:21:25