C#如何使用SelectNodes和SelectSingleNode方法

在C#的XML文档处理场景中，SelectNodes和SelectSingleNode是System.Xml命名空间下XmlNode类的两个核心方法，它们基于XPath路径表达式实现XML节点的快速查询，是处理XML数据时的常用工具。

两个方法的基本定义

SelectSingleNode方法用于根据指定的XPath表达式，从当前节点下匹配第一个符合条件的XML节点，如果不存在符合条件的节点则返回null。它的方法签名如下：

public XmlNode? SelectSingleNode(string xpath);

SelectNodes方法用于根据指定的XPath表达式，从当前节点下匹配所有符合条件的XML节点，返回的是一个XmlNodeList集合，如果不存在符合条件的节点则返回空集合。它的方法签名如下：

public XmlNodeList? SelectNodes(string xpath);

使用前的准备工作

要使用这两个方法，首先需要引入System.Xml命名空间，然后加载需要处理的XML文档。以下是加载XML文档的基础代码：

using System.Xml;

// 加载本地XML文件
XmlDocument xmlDoc = new XmlDocument();
xmlDoc.Load("test.xml"); // test.xml为待处理的XML文件路径

// 也可以加载XML格式的字符串
string xmlContent = "<?xml version="1.0" encoding="utf-8"?><root><user><name>张三</name><age>25</age></user><user><name>李四</name><age>30</age></user></root>";
xmlDoc.LoadXml(xmlContent);

SelectSingleNode的使用示例

假设我们有如下结构的XML文档，需要查询第一个user节点下的name值：

<?xml version="1.0" encoding="utf-8"?>
<root>
  <user>
    <name>张三</name>
    <age>25</age>
  </user>
  <user>
    <name>李四</name>
    <age>30</age>
  </user>
</root>

使用SelectSingleNode查询的代码如下：

// 获取根节点
XmlNode rootNode = xmlDoc.DocumentElement;

// 查询第一个user节点下的name节点
XmlNode? nameNode = rootNode.SelectSingleNode("user/name");

if (nameNode != null)
{
    string userName = nameNode.InnerText;
    Console.WriteLine(userName); // 输出：张三
}

SelectNodes的使用示例

同样基于上面的XML结构，如果需要查询所有user节点的age值，就需要使用SelectNodes方法：

// 查询所有user节点
XmlNodeList? userNodes = rootNode.SelectNodes("user");

if (userNodes != null)
{
    foreach (XmlNode userNode in userNodes)
    {
        // 在每个user节点下查询age节点
        XmlNode? ageNode = userNode.SelectSingleNode("age");
        if (ageNode != null)
        {
            Console.WriteLine(ageNode.InnerText);
        }
    }
}
// 输出：
// 25
// 30

带命名空间的XML处理

如果XML文档带有命名空间，直接使用XPath表达式会查询不到结果，需要先声明命名空间管理器。示例如下：

<?xml version="1.0" encoding="utf-8"?>
<root xmlns="http://ipipp.com/xmlns">
  <user>
    <name>张三</name>
  </user>
</root>

对应的C#处理代码：

// 创建命名空间管理器
XmlNamespaceManager nsmgr = new XmlNamespaceManager(xmlDoc.NameTable);
// 为命名空间添加前缀，第一个参数是前缀，第二个参数是命名空间URI
nsmgr.AddNamespace("ns", "http://ipipp.com/xmlns");

// 查询时使用前缀拼接XPath
XmlNode? nameNode = rootNode.SelectSingleNode("ns:user/ns:name", nsmgr);
if (nameNode != null)
{
    Console.WriteLine(nameNode.InnerText); // 输出：张三
}

常见注意事项

• XPath表达式的语法要正确，比如节点层级用/分隔，属性查询用@符号，例如查询age属性为25的user节点可以写成user[@age='25']。
• SelectSingleNode返回null时如果直接访问其属性会抛出空引用异常，建议先判断返回值是否为null再操作。
• SelectNodes返回的XmlNodeList是实时同步的，如果后续修改了XML文档，集合内容也会同步变化，不需要重新查询。
• 处理大体积XML文档时，频繁使用这两个方法可能会影响性能，建议合理规划查询逻辑，减少不必要的重复查询。

C#SelectNodesSelectSingleNodeXML解析XPath修改时间：2026-07-01 22:09:34