在 C# 中使用 LINQ to XML 读写带有命名空间的文档，核心在于理解 XNamespace 与 XName 的组合方式。许多标准格式如 RSS、Atom、SOAP 都定义了专属 URI，若忽略命名空间，查询表达式往往匹配不到任何节点。XNamespace 表示一个 XML 命名空间 URI，通过与本地名称相加生成带空间的 XName，从而让 LINQ 查询精确到目标元素。
理解 XNamespace 的基本用法
XNamespace 是 System.Xml.Linq 中的密封类，不能直接实例化，但可以通过字符串隐式转换得到。例如 XNamespace ns = "http://ippipp.com/ns"; 就会创建一个绑定到该 URI 的命名空间对象。本地名称与命名空间相加时，C# 重载了加法运算符，返回 XName 实例，这是 LINQ to XML 查询中元素名的标准表示。
需要特别注意，命名空间前缀（如 xml:、自定义前缀）只是序列化时的缩写，真正决定节点身份的是 URI。因此查询时只需关心 URI 与本地名，不必手动拼接前缀。下面代码展示如何声明命名空间并创建带空间的元素：
using System;
using System.Xml.Linq;
class Program
{
static void Main()
{
XNamespace ns = "http://ipipp.com/ns";
XElement root = new XElement(ns + "Root",
new XElement(ns + "Item", "值一"),
new XElement(ns + "Item", "值二")
);
Console.WriteLine(root);
}
}
上述代码生成的 XML 会自动带上命名空间声明，元素全名由 URI 与本地名共同决定。使用这种方式构造文档，可以避免后续查询时出现名称不匹配的问题。隐式转换让代码更简洁，也比使用 XName.Get 更易读。
查询带命名空间的文档
读取现有带命名空间文档时，必须先还原对应的 XNamespace，再与本地名组合进行查询。如果直接用字符串 "Item" 作为 Element 或 Descendants 的参数，只能找到无命名空间的元素，带空间的元素会被忽略。这是最常见的空结果原因。
以下示例加载一个带命名空间的 XML 并提取所有 Item 节点的文本。注意命名空间 URI 必须和文档中声明的一致，否则同样查不到：
using System;
using System.Xml.Linq;
class Program
{
static void Main()
{
string xml = @"<Root xmlns='http://ipipp.com/ns'>
<Item>值一</Item>
<Item>值二</Item>
</Root>";
XDocument doc = XDocument.Parse(xml);
XNamespace ns = "http://ipipp.com/ns";
foreach (var item in doc.Descendants(ns + "Item"))
{
Console.WriteLine(item.Value);
}
}
}
在真实项目中，文档可能来自网络或文件。使用 XDocument.Load 代替 Parse 即可。如果文档包含多个命名空间，可以为每个 URI 声明独立的 XNamespace 变量，再分别组合查询，逻辑清晰且不易出错。
处理默认命名空间与前缀
XML 中的默认命名空间通过 xmlns 属性声明，其子元素均隐式归属该 URI，但不带任何前缀。LINQ to XML 不区分默认空间与带前缀空间，统一用 XNamespace 表达。因此即便文档里没有前缀，查询时仍要绑定 URI。
当文档同时使用前缀与默认空间时，可声明多个 XNamespace 并配合本地名。如下代码演示从同时含前缀空间与默认空间的文档中取值：
using System;
using System.Xml.Linq;
class Program
{
static void Main()
{
string xml = @"<Root xmlns='http://ipipp.com/default' xmlns:custom='http://ipipp.com/custom'>
<Item>默认空间</Item>
<custom:Item>前缀空间</custom:Item>
</Root>";
XDocument doc = XDocument.Parse(xml);
XNamespace def = "http://ipipp.com/default";
XNamespace cust = "http://ipipp.com/custom";
Console.WriteLine(doc.Element(def + "Root").Element(def + "Item").Value);
Console.WriteLine(doc.Element(def + "Root").Element(cust + "Item").Value);
}
}
这段代码说明只要 URI 正确，无论序列化形式如何，都能稳定访问。不要试图用 "custom:Item" 这样的带前缀字符串直接查询，因为 LINQ to XML 只认 URI 与本地名组合，前缀仅影响输出外观。
常见误区与避坑建议
一个典型错误是在查询时用字符串拼接形成带前缀的名称，例如 "ns:Item"，这实际创建了一个本地名为 "ns:Item" 的无命名空间名称，与文档中位于某 URI 下的 "Item" 完全不同。另一个误区是认为改了 XElement 的 Name 属性能切换命名空间，实际上 Name 是只读的，必须通过重新构造元素或替换节点来实现。
建议将项目中用到的命名空间 URI 提取为常量，避免拼写不一致。对于复杂文档，可先输出 doc.Root.ToString() 确认空间结构，再编写查询。下表列出常见问题与处理方式：
| 现象 | 原因 | 解决 |
|---|---|---|
| Descendants 返回空 | 未绑定命名空间 URI | 用 XNamespace 组合本地名 |
| 取到错误节点 | 本地名冲突但 URI 不同 | 显式指定对应 XNamespace |
| 输出无前缀 | 未设置命名空间前缀序列化 | 使用 XElement 构造时带前缀的命名空间声明 |
掌握 XNamespace 后，处理任何标准或自定义带空间 XML 都会变得直接。核心记忆点就是：URI 加本地名等于准确节点身份，前缀只是表面写法。
C#LINQ_to_XMLXNamespace修改时间：2026-08-05 22:09:28