C# XDocument怎么查询指定节点 XElement.Descendants方法

在C#的XML处理场景中，XDocument类提供了轻量级的XML文档操作能力，而XElement.Descendants方法是遍历和查询XML节点的常用工具，能够返回当前元素所有层级的指定名称的后代元素集合，无需手动逐层遍历节点。

XElement.Descendants方法基本定义

XElement.Descendants是XElement类的实例方法，有两个重载形式，分别用于返回所有后代元素和指定名称的后代元素，方法定义如下：

• 无参数重载：返回当前元素所有层级的后代XElement集合
• 带XName参数的重载：返回当前元素所有层级中名称匹配指定XName的后代XElement集合

该方法的返回类型是IEnumerable<XElement>，因此可以使用LINQ语句进一步筛选和处理结果。

基础查询示例

假设我们有如下结构的XML文档，需要查询所有名称为student的节点：

<?xml version="1.0" encoding="utf-8"?>
<root>
  <class id="1">
    <student>
      <name>张三</name>
      <age>18</age>
    </student>
    <student>
      <name>李四</name>
      <age>19</age>
    </student>
  </class>
  <class id="2">
    <student>
      <name>王五</name>
      <age>20</age>
    </student>
  </class>
</root>

使用XDocument加载该XML并调用Descendants方法的代码如下：

using System;
using System.Linq;
using System.Xml.Linq;

class Program
{
    static void Main()
    {
        // 加载XML文档，实际开发中可替换为从文件或字符串加载
        string xmlContent = @"<?xml version=""1.0"" encoding=""utf-8""?>
<root>
  <class id=""1"">
    <student>
      <name>张三</name>
      <age>18</age>
    </student>
    <student>
      <name>李四</name>
      <age>19</age>
    </student>
  </class>
  <class id=""2"">
    <student>
      <name>王五</name>
      <age>20</age>
    </student>
  </class>
</root>";
        XDocument doc = XDocument.Parse(xmlContent);
        // 查询所有名称为student的后代节点
        var students = doc.Root.Descendants("student");
        foreach (var student in students)
        {
            string name = student.Element("name")?.Value;
            string age = student.Element("age")?.Value;
            Console.WriteLine($"姓名：{name}，年龄：{age}");
        }
    }
}

上述代码中，doc.Root获取XML的根元素root，调用Descendants("student")会返回所有层级的student节点，无论它们位于哪个class节点下，最终遍历输出所有学生的姓名和年龄。

带筛选条件的查询

Descendants方法返回的集合支持LINQ查询，可以结合节点的属性、子元素内容做进一步筛选，比如查询年龄大于18岁的学生节点：

using System;
using System.Linq;
using System.Xml.Linq;

class Program
{
    static void Main()
    {
        string xmlContent = @"<?xml version=""1.0"" encoding=""utf-8""?>
<root>
  <class id=""1"">
    <student>
      <name>张三</name>
      <age>18</age>
    </student>
    <student>
      <name>李四</name>
      <age>19</age>
    </student>
  </class>
  <class id=""2"">
    <student>
      <name>王五</name>
      <age>20</age>
    </student>
  </class>
</root>";
        XDocument doc = XDocument.Parse(xmlContent);
        // 筛选年龄大于18的student节点
        var targetStudents = doc.Root.Descendants("student")
            .Where(s => int.Parse(s.Element("age").Value) > 18);
        foreach (var student in targetStudents)
        {
            string name = student.Element("name")?.Value;
            Console.WriteLine($"符合条件的学生姓名：{name}");
        }
    }
}

使用注意事项

节点名称匹配规则

Descendants方法的参数区分大小写，XML节点名称是Student时，传入"student"将无法匹配到节点，需要和XML中的实际名称完全一致。

空值处理

当查询的节点不存在时，Descendants方法会返回空集合，不会抛出异常，但如果后续调用Element("xxx").Value时，若Element("xxx")返回null，会触发空引用异常，建议使用?运算符做空值判断，如student.Element("name")?.Value。

性能说明

Descendants方法会遍历当前元素下所有层级的节点，对于层级很深、节点数量很多的XML文档，频繁调用可能会影响性能，若只需要查询直接子节点，建议使用Elements方法替代。

C#XDocumentXElement_DescendantsXML查询修改时间：2026-06-16 12:21:44