C#如何将XML节点转换为对象 反序列化单个元素

在C#开发中，处理XML格式数据是常见的工作场景，将XML中的单个节点转换为对应的实体对象，能够大幅简化后续的数据操作逻辑，提升开发效率。

准备工作：定义匹配的实体类

要实现XML节点到对象的转换，首先需要定义和XML节点结构完全匹配的实体类，并且需要通过特性标注来明确节点和属性的对应关系。假设我们有如下的XML单个节点：

<User>
    <Id>1001</Id>
    <Name>张三</Name>
    <Age>25</Age>
    <Email>test@ipipp.com</Email>
</User>

对应的实体类定义如下，需要使用System.Xml.Serialization命名空间下的特性：

using System.Xml.Serialization;

[XmlRoot("User")]
public class User
{
    [XmlElement("Id")]
    public int Id { get; set; }

    [XmlElement("Name")]
    public string Name { get; set; }

    [XmlElement("Age")]
    public int Age { get; set; }

    [XmlElement("Email")]
    public string Email { get; set; }
}

核心实现：反序列化单个XML节点

接下来使用XmlSerializer类完成反序列化操作，核心逻辑是将XML节点转换为XmlReader对象，再通过序列化器的Deserialize方法得到实体对象。完整实现代码如下：

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

public class XmlNodeConverter
{
    public static T ConvertNodeToObject<T>(XmlNode xmlNode) where T : class
    {
        if (xmlNode == null)
        {
            return null;
        }
        // 创建对应的序列化器
        XmlSerializer serializer = new XmlSerializer(typeof(T));
        // 将XmlNode转换为XmlReader
        using (XmlReader reader = new XmlNodeReader(xmlNode))
        {
            // 执行反序列化操作
            return serializer.Deserialize(reader) as T;
        }
    }
}

调用示例与结果验证

我们可以编写测试代码来验证转换逻辑是否正确，假设我们已经获取到了上述的User节点，调用方式如下：

using System.Xml;

class Program
{
    static void Main(string[] args)
    {
        // 模拟获取到的XML节点，实际场景中可能来自XML文档解析
        string xmlContent = "<User><Id>1001</Id><Name>张三</Name><Age>25</Age><Email>test@ipipp.com</Email></User>";
        XmlDocument xmlDoc = new XmlDocument();
        xmlDoc.LoadXml(xmlContent);
        XmlNode userNode = xmlDoc.DocumentElement;

        // 调用转换方法
        User user = XmlNodeConverter.ConvertNodeToObject<User>(userNode);

        if (user != null)
        {
            Console.WriteLine($"Id: {user.Id}");
            Console.WriteLine($"Name: {user.Name}");
            Console.WriteLine($"Age: {user.Age}");
            Console.WriteLine($"Email: {user.Email}");
        }
    }
}

运行上述代码后，会正确输出User节点的所有属性值，说明反序列化操作成功。

注意事项

• 实体类的特性和XML节点的名称必须完全匹配，包括大小写，否则会导致反序列化失败或者属性值为空。
• 如果XML节点中包含命名空间，需要在实体类的XmlRoot特性中指定对应的命名空间，否则无法正确匹配。
• 如果XML节点的属性较多，或者使用自定义的类型，需要确保自定义类型也支持XML序列化，或者编写对应的转换逻辑。
• 如果XML节点中存在空值或者不符合类型定义的数值，反序列化时会抛出异常，需要提前做好异常处理。

C#XML反序列化XmlSerializer节点转换对象映射修改时间：2026-06-28 23:54:22