C#开发中解析XML是常见需求，当XML文档包含命名空间时，常规的节点查询方式往往会失效，需要配合命名空间管理器才能完成正确的解析操作。命名空间的作用是避免不同XML文档中相同节点名的冲突，在解析时必须明确指定对应的命名空间URI才能定位到目标节点。
XML命名空间的基本规则
XML命名空间通常通过xmlns属性定义，分为默认命名空间和带前缀的命名空间两种形式。默认命名空间会作用于当前节点及其所有子节点，带前缀的命名空间需要配合前缀使用才能生效。示例如下：
<?xml version="1.0" encoding="utf-8"?> <root xmlns="http://default.namespace.com" xmlns:custom="http://custom.namespace.com"> <defaultNode>默认命名空间下的节点</defaultNode> <custom:customNode>自定义前缀命名空间下的节点</custom:customNode> </root>
使用XmlDocument解析带命名空间的XML
XmlDocument是.NET Framework早期提供的XML文档操作类，处理命名空间需要配合XmlNamespaceManager使用，步骤如下：
- 加载XML文档到XmlDocument实例
- 创建XmlNamespaceManager实例，添加对应的命名空间映射
- 查询节点时传入XmlNamespaceManager，使用带前缀的节点名查询
完整代码示例如下：
using System;
using System.Xml;
class Program
{
static void Main()
{
// 待解析的XML字符串
string xmlContent = @"<?xml version='1.0' encoding='utf-8'?>
<root xmlns='http://default.namespace.com' xmlns:custom='http://custom.namespace.com'>
<defaultNode>默认命名空间内容</defaultNode>
<custom:customNode>自定义命名空间内容</custom:customNode>
</root>";
XmlDocument xmlDoc = new XmlDocument();
xmlDoc.LoadXml(xmlContent);
// 创建命名空间管理器，传入文档的NameTable
XmlNamespaceManager nsManager = new XmlNamespaceManager(xmlDoc.NameTable);
// 添加默认命名空间映射，自定义前缀d
nsManager.AddNamespace("d", "http://default.namespace.com");
// 添加自定义前缀命名空间映射
nsManager.AddNamespace("c", "http://custom.namespace.com");
// 查询默认命名空间下的节点，需要使用自定义前缀d
XmlNode defaultNode = xmlDoc.SelectSingleNode("//d:defaultNode", nsManager);
if (defaultNode != null)
{
Console.WriteLine("默认命名空间节点内容：" + defaultNode.InnerText);
}
// 查询自定义前缀命名空间下的节点
XmlNode customNode = xmlDoc.SelectSingleNode("//c:customNode", nsManager);
if (customNode != null)
{
Console.WriteLine("自定义命名空间节点内容：" + customNode.InnerText);
}
}
}
使用XDocument解析带命名空间的XML
XDocument是LINQ to XML提供的轻量级XML操作类，处理命名空间的方式更简洁，通过XNamespace类型直接定义命名空间即可，不需要额外创建管理器。步骤如下：
- 加载XML到XDocument实例
- 定义XNamespace对象，对应XML中的命名空间URI
- 拼接带命名空间的节点名进行查询
完整代码示例如下：
using System;
using System.Xml.Linq;
class Program
{
static void Main()
{
// 待解析的XML字符串
string xmlContent = @"<?xml version='1.0' encoding='utf-8'?>
<root xmlns='http://default.namespace.com' xmlns:custom='http://custom.namespace.com'>
<defaultNode>默认命名空间内容</defaultNode>
<custom:customNode>自定义命名空间内容</custom:customNode>
</root>";
XDocument xDoc = XDocument.Parse(xmlContent);
// 定义默认命名空间
XNamespace defaultNs = "http://default.namespace.com";
// 定义自定义前缀命名空间
XNamespace customNs = "http://custom.namespace.com";
// 查询默认命名空间下的节点，直接拼接命名空间和节点名
XElement defaultNode = xDoc.Root.Element(defaultNs + "defaultNode");
if (defaultNode != null)
{
Console.WriteLine("默认命名空间节点内容：" + defaultNode.Value);
}
// 查询自定义前缀命名空间下的节点
XElement customNode = xDoc.Root.Element(customNs + "customNode");
if (customNode != null)
{
Console.WriteLine("自定义命名空间节点内容：" + customNode.Value);
}
}
}
两种解析方式的对比
两种方式的核心差异如下：
| 对比项 | XmlDocument | XDocument |
|---|---|---|
| 所属技术栈 | 传统XML DOM | LINQ to XML |
| 命名空间处理 | 需要XmlNamespaceManager | 直接使用XNamespace拼接 |
| 查询语法 | XPath语法 | LINQ查询或Element方法 |
| 代码简洁度 | 相对繁琐 | 更简洁易读 |
常见问题说明
很多开发者解析失败的原因是查询节点时没有带上命名空间，比如直接查询defaultNode而不是带命名空间前缀的形式。另外需要注意，命名空间匹配的是URI而不是前缀，即使XML中前缀和代码中定义的前缀不同，只要URI一致就可以正确匹配。如果XML中没有命名空间，就不需要额外处理命名空间相关逻辑，直接用常规方式解析即可。
C#xml解析命名空间XmlNamespaceManagerXDocument修改时间：2026-07-17 14:51:27