在使用C#处理XML文档时，命名空间经常成为数据交换中的一个隐性障碍。不同系统生成的XML可能带有不同的命名空间前缀，或者完全依赖默认命名空间，这给元素匹配和数据提取带来不少麻烦。LINQ to XML作为.NET平台下轻量级的XML编程接口，其命名空间处理方式与传统的XmlDocument有显著区别。理解了XNamespace对象的工作机制，就能灵活地添加或删除文档中的命名空间，而不会破坏原有的数据结构。
理解LINQ to XML中的命名空间对象
在LINQ to XML中，命名空间由XNamespace类表示，元素名称则由XName类封装。一个完整的XML限定名可以拆解为命名空间URI和本地名称两部分，比如<ns:book>中的ns只是前缀，真正标识命名空间的是URI。因此创建带命名空间的元素时，正确的做法是通过XNamespace实例与本地名称相加来得到XName。
下面的代码展示了两种创建带命名空间元素的方式：一种是使用默认命名空间，元素没有前缀但继承了命名空间URI；另一种是指定前缀，让序列化后的元素带有ns:这样的前缀。
using System;
using System.Xml.Linq;
class Program
{
static void Main()
{
// 默认命名空间
XNamespace defaultNs = "http://ippipp.com/books";
XElement book1 = new XElement(defaultNs + "book",
new XAttribute("id", "001"),
new XElement(defaultNs + "title", "C#编程指南")
);
// 带前缀的命名空间
XNamespace ns = "http://ippipp.com/books";
XElement root = new XElement(ns + "library",
new XAttribute(XNamespace.Xmlns + "ns", ns),
new XElement(ns + "book", "内容")
);
Console.WriteLine(book1);
Console.WriteLine(root);
}
}
从输出结果可以看到，默认命名空间元素不会显示前缀，但内部保存的XName.Namespace属性仍然是http://ippipp.com/books。在后续查询时如果不使用相同的XNamespace，即使本地名称相同也无法匹配，这是很多人在使用LINQ to XML时容易忽略的一点。
向XML元素添加命名空间
添加命名空间有两种典型场景：第一种是在构建新的XML结构时直接指定命名空间；第二种是对已有的XElement进行改造，让原本没有命名空间（或命名空间为空）的元素拥有一个命名空间URI。由于XElement本身是不可变对象，我们不能直接修改其Name属性，只能通过创建新元素并复制子内容的方式来达到目的。
先来看创建时添加命名空间。前面已经演示了默认和前缀两种方式，这里再补充一个技巧：多个元素共享同一个XNamespace实例时，序列化后的XML会自动处理命名空间声明的重复问题。例如下面的代码虽然每个元素都使用了ns + "xxx"，但最终只会出现一次xmlns:ns声明。
XNamespace ns = "http://ippipp.com/orders";
XElement order = new XElement(ns + "order",
new XAttribute(XNamespace.Xmlns + "ns", ns),
new XElement(ns + "customer", "张三"),
new XElement(ns + "items",
new XElement(ns + "item",
new XAttribute("sku", "A100"),
"键盘"
)
)
);
Console.WriteLine(order);
如果需要对一个已经存在的无命名空间元素添加默认命名空间，常见做法是遍历该元素及其子元素，逐个创建新的XElement，并在名称前加上目标命名空间。下面的扩展方法AddDefaultNamespace接收一个目标XNamespace，将元素树中所有元素的名称都转换为带该命名空间的版本，同时保留原有属性和子节点。
public static XElement AddDefaultNamespace(this XElement source, XNamespace ns)
{
return new XElement(ns + source.Name.LocalName,
source.Attributes(),
source.Nodes().Select(node =>
node is XElement child ? child.AddDefaultNamespace(ns) : node
)
);
}
调用方式很简单：var result = element.AddDefaultNamespace(XNamespace.Get("http://ippipp.com/new"));。需要注意的是，如果原元素已经有一个非空的命名空间，这个方法会直接替换掉原有命名空间，而不是添加第二个。若要实现添加前缀声明而非替换默认命名空间，则需要在根元素上增加一个xmlns:prefix属性，但元素本身的XName并不需要改变，这时只是向根元素注入新的命名空间声明，供后续元素引用。
从XML元素中删除命名空间
删除命名空间同样面临不可变性的约束。无论是删除默认命名空间还是删除某个前缀声明，最终都需要重建元素树。删除默认命名空间意味着把元素的XName从ns + localName改回仅使用localName，而删除前缀声明则是从根元素的属性集合中移除XNamespace.Xmlns + "prefix"对应的属性。
先实现一个通用的移除命名空间方法。它递归地处理每个元素，忽略原有的XNamespace，只保留本地名称，同时复制所有属性和非元素节点。需要注意的是，原来带有命名空间前缀的属性（如ns:type）在重建后也需要处理，但大多数业务场景中属性命名空间较少，可以按需扩展。
public static XElement RemoveAllNamespaces(this XElement source)
{
// 删除元素命名空间，保留本地名称
XElement newElement = new XElement(source.Name.LocalName);
// 复制属性，同时去掉属性命名空间
foreach (XAttribute attr in source.Attributes())
{
if (!attr.IsNamespaceDeclaration)
{
newElement.Add(new XAttribute(attr.Name.LocalName, attr.Value));
}
}
// 递归处理子节点
foreach (XNode node in source.Nodes())
{
if (node is XElement child)
{
newElement.Add(child.RemoveAllNamespaces());
}
else
{
newElement.Add(node);
}
}
return newElement;
}
调用RemoveAllNamespaces后，所有元素都失去了命名空间，包括默认命名空间和通过前缀声明的命名空间。如果只想删除某一个特定的前缀声明，可以只对根节点进行操作，通过删除xmlns:prefix属性实现。但这样并不会修改子元素的XName，因此子元素可能仍然引用已删除的命名空间URI，导致XML在解析时出现不一致。更好的做法是结合前缀对应的URI，将引用该URI的元素名称统一替换为无命名空间版本，或者更精确地重建元素。
另一种常见的需求是将带前缀的命名空间转换为默认命名空间，或者反过来。本质上还是重新构造XName，只不过目标XNamespace保持不变，只是调整序列化时的前缀展示。由于LINQ to XML在内部根据xmlns属性自动推断前缀，开发人员只需控制XAttribute的添加即可。例如创建一个使用默认命名空间的元素，同时添加一个xmlns:ns属性并赋相同URI，序列化后会采用默认命名空间形式，前缀声明仍然保留但不会出现在元素名中。
操作命名空间时容易忽略的细节
XName的相等性判断同时考虑命名空间URI和本地名称，因此ns1 + "item"与ns2 + "item"是两个完全不同的名称，即使URI字符串相同但XNamespace实例不同也会被视为不同。在实际项目中应当使用同一个XNamespace静态变量或缓存实例，避免无意中造成查询失败。
另外，删除命名空间操作会移除所有命名空间声明属性，但不会影响CDATA、注释等节点。如果需要保留原XML的格式和声明信息，手动重建元素树时需要额外处理XDocument级别的声明。一个稳定可靠的做法是使用XDocument包装根元素后再进行转换，这样XDocument.Declaration可以原样保留。
在性能敏感的场景下，频繁地添加或删除命名空间意味着反复创建完整的元素树，内存开销较大。如果只需要修改少数几个元素，可以考虑使用XElement.ReplaceWith来局部替换，而不是整树遍历。例如只删除某个特定子元素的命名空间，可以先构造该元素的无命名空间版本，然后用ReplaceWith替换旧节点，这样性能会优于全树重建。
C# LINQ to XML命名空间XNamespace修改时间：2026-09-07 10:38:36