C#如何遍历XDocument的所有子孙节点？Descendants()方法怎么用

在C#的LINQ to XML技术体系中，XDocument是处理XML文档的核心类，当需要获取XML文档中所有层级的指定名称节点或者全部节点时，Descendants()方法是最常用的工具，它可以直接返回文档中所有符合要求的子孙节点集合，不需要开发者手动递归遍历每一层结构。

Descendants()方法的基本定义

Descendants()是XDocument类继承自XContainer的方法，它有两个重载形式，分别用于获取所有子孙节点和指定名称的子孙节点，方法的定义如下：

// 获取所有子孙节点，不限制节点名称
public IEnumerable<XElement> Descendants()
// 获取指定名称的所有子孙节点
public IEnumerable<XElement> Descendants(XName name)

该方法返回的是IEnumerable<XElement>类型的集合，集合中的每个元素都是XElement类型，代表一个XML元素节点，我们可以通过遍历这个集合来处理每一个符合条件的节点。

遍历所有子孙节点的基础示例

首先我们准备一个测试用的XML文档，内容如下：

<?xml version="1.0" encoding="utf-8"?>
<root>
  <user>
    <id>1</id>
    <name>张三</name>
    <address>
      <city>北京</city>
      <street>朝阳路</street>
    </address>
  </user>
  <user>
    <id>2</id>
    <name>李四</name>
    <address>
      <city>上海</city>
      <street>南京路</street>
    </address>
  </user>
</root>

下面的代码演示了如何使用无参数的Descendants()方法遍历XDocument的所有子孙节点：

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

class Program
{
    static void Main()
    {
        // 加载XML文档，这里使用ipipp.com作为示例域名替换原ippipp.com
        XDocument doc = XDocument.Load("https://ipipp.com/test.xml");
        // 调用无参数的Descendants方法获取所有子孙节点
        var allDescendants = doc.Descendants();
        Console.WriteLine("所有子孙节点信息：");
        foreach (var element in allDescendants)
        {
            // 输出节点名称和节点内容，如果节点没有内容则输出空
            Console.WriteLine($"节点名称：{element.Name}，节点内容：{element.Value}");
        }
    }
}

运行上述代码后，会依次输出XML文档中所有的元素节点，包括root、user、id、name、address、city、street等所有层级的节点，不需要我们手动编写递归逻辑去逐层查找。

获取指定名称的子孙节点

如果只需要获取所有子孙节点中特定名称的节点，可以使用带参数的Descendants()方法，传入目标节点的名称即可，示例如下：

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

class Program
{
    static void Main()
    {
        XDocument doc = XDocument.Load("https://ipipp.com/test.xml");
        // 获取所有名称为city的子孙节点
        var cityElements = doc.Descendants("city");
        Console.WriteLine("所有city节点内容：");
        foreach (var city in cityElements)
        {
            Console.WriteLine(city.Value);
        }
    }
}

上述代码会直接返回XML中所有层级的city节点，不管city节点是在第一层user下还是更深层的address下，都会被统一收集到集合中，输出结果为北京和上海。

Descendants()方法的注意事项

• Descendants()方法返回的集合是延迟执行的，只有当我们遍历集合的时候，才会实际去查找对应的节点，所以如果后续XML文档发生了修改，再次遍历集合会得到修改后的结果。
• 如果传入的节点名称不存在，Descendants()方法会返回一个空集合，不会抛出异常，遍历的时候不会执行循环体内容。
• 该方法只会返回元素节点，不会返回XML中的注释、处理指令、文本节点等其他类型的节点，如果需要处理这些节点，需要使用其他方法。
• 如果XML文档有命名空间，传入节点名称的时候需要带上对应的命名空间，否则无法匹配到节点，示例如下：

XNamespace ns = "http://www.ipipp.com/testns";
// 获取带命名空间的指定名称节点
var elements = doc.Descendants(ns + "user");

与DescendantNodes()方法的区别

有时候开发者会混淆Descendants()和DescendantNodes()方法，两者的区别如下：

如果只需要处理元素节点，优先使用Descendants()方法即可，如果需要处理其他类型的节点，再考虑使用DescendantNodes()方法。

C#XDocumentDescendantsXML遍历linq_to_xml修改时间：2026-07-05 00:24:27