C# 序列化xml时如何自定义节点名称

在C#开发中，使用XmlSerializer进行xml序列化时，默认的节点名称会和类的属性名保持一致，很多场景下我们需要自定义节点名称来匹配接口要求或者已有的xml规范。本文会介绍几种常用的自定义节点名称的方法，同时给出完整的代码示例。

使用XmlElement特性自定义节点名称

XmlElement是System.Xml.Serialization命名空间下的特性，最常用的场景就是指定序列化后生成的xml节点名称，只需要给对应属性添加该特性并指定ElementName参数即可。

首先定义一个测试用的实体类，给属性添加XmlElement特性指定自定义节点名：

using System;
using System.Xml.Serialization;

namespace XmlSerializationDemo
{
    [XmlRoot("user_info")]
    public class User
    {
        // 序列化后节点名为user_id，而非属性名UserId
        [XmlElement(ElementName = "user_id")]
        public int UserId { get; set; }

        // 序列化后节点名为user_name，而非属性名UserName
        [XmlElement(ElementName = "user_name")]
        public string UserName { get; set; }

        // 未添加特性，节点名和属性名一致
        public int Age { get; set; }
    }
}

接下来编写序列化代码，验证节点名称是否符合预期：

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

namespace XmlSerializationDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            User user = new User
            {
                UserId = 1001,
                UserName = "张三",
                Age = 25
            };

            XmlSerializer serializer = new XmlSerializer(typeof(User));
            using (StringWriter writer = new StringWriter())
            {
                serializer.Serialize(writer, user);
                string xmlContent = writer.ToString();
                Console.WriteLine(xmlContent);
            }
        }
    }
}

执行上述代码后生成的xml内容如下：

<?xml version="1.0" encoding="utf-16"?>
<user_info>
  <user_id>1001</user_id>
  <user_name>张三</user_name>
  <Age>25</Age>
</user_info>

可以看到添加XmlElement特性的属性，序列化后的节点名已经变成了我们指定的名称，未添加特性的属性则保持原属性名作为节点名。

自定义根节点名称

如果需要自定义整个xml的根节点名称，可以给类添加XmlRoot特性，指定RootElementName参数，上面的示例中已经使用了该特性，根节点名被设置为user_info，而非默认的类名User。

处理命名空间相关的节点名称

如果序列化的xml需要包含命名空间，并且希望节点名称带命名空间前缀，可以使用XmlElement特性的Namespace参数，示例如下：

using System;
using System.Xml.Serialization;

namespace XmlSerializationDemo
{
    [XmlRoot("user", Namespace = "http://test.ipipp.com")]
    public class UserWithNamespace
    {
        [XmlElement(ElementName = "id", Namespace = "http://test.ipipp.com")]
        public int Id { get; set; }

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

序列化后的xml会包含对应的命名空间信息，节点名称会按照指定的规则生成。

注意事项

• XmlElement特性的ElementName参数值需要和对接方要求的xml节点名完全一致，区分大小写。
• 如果属性是集合类型，需要结合XmlArray和XmlArrayItem特性来自定义集合对应的节点名称，避免默认生成的节点名不符合预期。
• 序列化时如果需要去掉xml声明，可以自定义XmlWriterSettings来调整输出格式。

通过上述方法，就可以灵活自定义C# xml序列化时的各类节点名称，满足不同场景下的xml格式要求。

C#xml_serializationXmlSerializerXmlElement节点名称自定义修改时间：2026-07-09 15:27:11