在C#里使用XmlSerializer做对象序列化时，很多人会把注意力集中在XmlRoot、XmlElement这些特性上，但XmlType特性的Namespace属性同样是一个容易被忽略却非常实用的控制点。它主要作用于类型本身，影响的是该类型在XML Schema中作为complexType出现时的命名空间，也会影响嵌套对象序列化时子元素所处的命名空间。尤其是在对接第三方系统、需要精确控制每个元素命名空间的场景下，掌握XmlType的用法可以少走很多弯路。
XmlType特性如何为类型指定命名空间
XmlTypeAttribute位于System.Xml.Serialization命名空间，可以应用在类、结构体、枚举和接口上。它有两个常用属性：TypeName和Namespace。Namespace属性默认值为空字符串，表示该类型不属于任何XML命名空间。如果在类上显式标注[XmlType(Namespace = "http://www.ipipp.com/address")]，那么在序列化包含该类型成员的对象时，相关元素就会被放进这个命名空间。
下面通过一个地址模型来观察具体行为。定义Address类并给它指定命名空间，然后在Customer类中把它作为成员。
using System;
using System.IO;
using System.Xml.Serialization;
[XmlType(Namespace = "http://www.ipipp.com/address")]
public class Address
{
public string City { get; set; }
public string Street { get; set; }
}
public class Customer
{
public string Name { get; set; }
[XmlElement(ElementName = "Location")]
public Address Address { get; set; }
}
public class Program
{
public static void Main()
{
Customer customer = new Customer
{
Name = "张三",
Address = new Address
{
City = "上海",
Street = "南京路"
}
};
XmlSerializer serializer = new XmlSerializer(typeof(Customer));
using (StringWriter writer = new StringWriter())
{
serializer.Serialize(writer, customer);
Console.WriteLine(writer.ToString());
}
}
}
上面代码没有在Customer.Address属性上使用XmlElement的Namespace属性，但序列化后的Location元素仍然会落入Address类型声明的命名空间。输出如下：
<Customer xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<Name>张三</Name>
<Location xmlns="http://www.ipipp.com/address">
<City>上海</City>
<Street>南京路</Street>
</Location>
</Customer>
可以看到，Location元素通过默认命名空间声明xmlns="http://www.ipipp.com/address"进入了address命名空间，其子元素City和Street也自然继承该默认命名空间。这种用法适合让同一类型在不同业务对象中保持一致命名空间，而不需要逐个成员重复指定。
需要注意，如果Address类型本身作为根元素序列化，控制根元素命名空间的主要是XmlRoot特性。若类上只有XmlType而没有XmlRoot，根元素通常会落入空命名空间，除非显式补充XmlRoot。因此当整个文档根节点也需要命名空间时，应当同时设置XmlRoot(Namespace = "...")。
命名空间优先级的对比：XmlType、XmlElement与XmlRoot
在实际项目中，同一个类可能被多个父类包含，而不同的父类又要求子元素落在不同命名空间。这时就需要理清几个特性之间的优先级。简单来说，成员上的XmlElement或XmlArrayItem等特性具有最高优先级，其次是类型上的XmlType，而XmlRoot只对根元素有效。
用一个发货信息模型来说明。假设ShippingInfo类默认声明了types命名空间，但Order类希望它的Shipping成员使用shipping命名空间，只需在属性上覆盖Namespace即可。
[XmlType(Namespace = "http://www.ipipp.com/types")]
public class ShippingInfo
{
public string Carrier { get; set; }
}
public class Order
{
[XmlElement(Namespace = "http://www.ipipp.com/order")]
public string OrderId { get; set; }
[XmlElement(Namespace = "http://www.ipipp.com/shipping")]
public ShippingInfo Shipping { get; set; }
}
这种情况下，ShippingInfo类自身的XmlType.Namespace被成员特性覆盖，序列化后的Shipping元素会落在shipping命名空间而不是types命名空间。与之相对，如果成员特性没有指定Namespace，才会回退到类型的XmlType命名空间。
这个优先级关系同样适用于集合。外层容器元素的命名空间由XmlArray控制，数组项元素的命名空间由XmlArrayItem控制。当XmlArrayItem没有设置Namespace时，数组项会使用元素类型的XmlType.Namespace。下面的代码展示了一个公司拥有多个分支地址的场景。
public class Company
{
[XmlArray(Namespace = "http://www.ipipp.com/company")]
[XmlArrayItem(Namespace = "http://www.ipipp.com/address", ElementName = "Branch")]
public List<Address> Branches { get; set; }
}
如果在XmlArrayItem中省略Namespace，那么Branch元素就会使用Address类上的命名空间。这个顺序在生成符合SOAP或自定义Schema的XML时非常关键，可以避免命名空间写错位置导致的校验失败。
使用XmlSerializerNamespaces管理命名空间前缀
上面的示例生成的XML都使用了默认命名空间，也就是xmlns="..."的形式。虽然语义正确，但在某些消息协议中会更倾向于使用命名空间前缀，例如addr:Location。这可以通过向Serialize方法传递一个XmlSerializerNamespaces实例来实现。
XmlSerializerNamespaces ns = new XmlSerializerNamespaces();
ns.Add("addr", "http://www.ipipp.com/address");
serializer.Serialize(writer, customer, ns);
传入这个对象后，序列化器会为指定URI生成前缀声明，并把属于该命名空间的元素写成带前缀的形式。例如：
<Customer xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<Name>张三</Name>
<addr:Location xmlns:addr="http://www.ipipp.com/address">
<addr:City>上海</addr:City>
<addr:Street>南京路</addr:Street>
</addr:Location>
</Customer>
这样做的好处是，当文档中同时存在多个命名空间时，前缀能让元素来源更清晰。需要注意的是，XmlSerializerNamespaces中配置的URI必须与特性中声明的Namespace完全一致，否则不会应用前缀。另外，如果某些元素使用默认命名空间，而另一些使用前缀，XML的混合命名空间规则可能会让文档变得难以阅读，所以通常建议同一个文档统一采用一种风格。
常见误区与排查建议
第一个常见误区是认为设置了XmlType.Namespace就能让根元素也带上命名空间。实际根元素需要单独的XmlRoot特性，或者使用XmlRootAttribute动态指定。如果只标注类上的XmlType，序列化根元素时很可能得到<Address>而不是<addr:Address xmlns:addr="...">，这会导致文档结构与预期不符。
第二个误区是忽略了命名空间的前缀与默认命名空间在XML规范中的差异。同一个默认命名空间会自动作用于所有未声明命名空间的子元素，但前缀不会自动继承。当你从默认命名空间切换为前缀方式时，必须保证所有属于该命名空间的元素都正确带上前缀，否则子元素可能会悄悄落入空命名空间。
第三个误区是在成员特性中既设置了Namespace，又期望类型上的XmlType.Namespace生效。前面已经提到，成员特性优先级更高，所以一旦在XmlElement中写了不同的Namespace，类型声明就会被覆盖。排查XML命名空间问题时，可以先检查类型定义，再检查成员特性，最后检查序列化参数中的XmlSerializerNamespaces，一般就能定位到问题。
C# XmlSerializerXmlType特性XML命名空间修改时间：2026-09-23 04:45:22