HtmlAgilityPack官方文档(四)【Traversing】

关注

翻译最新推荐文章于 2026-05-21 09:49:45 发布 1.4k 阅读 AI 写同款· GEO 优化 ›

HtmlAgilityPack：高效的.NET HTML分析与操作工具 HtmlAgilityPack 是.NET平台上的一个强大HTML解析器，它允许开发者在内存中加载和操作HTML文档，就像操作DOM树一样。这个库能够解析不规范的HTML文档，并提供了强大的节点选择和修改功能。尽管它不像正统的XML解析器那样严格，但它在处理真实世界中的网页内容时表现出更高的灵活性和适应性。使用HtmlAgilityPack可以极大简化网络爬虫、数据抓取、内容提取等任务，对于需要从网页中提取结构化数据的开发者而言，它是一个不可或缺的工具。阅读详情

Traversing允许您遍历HTML节点。

属性

名称	描述
ChildNodes	Gets all the children of the node.
FirstChild	Gets the first child of the node.
LastChild	Gets the last child of the node.
NextSibling	Gets the HTML node immediately following this element.
ParentNode	Gets the parent of this node (for nodes that can have parents).

方法

名称	描述
Ancestors()	Gets all the ancestor of the node.
Ancestors(String)	Gets ancestors with matching name.
AncestorsAndSelf()	Gets all anscestor nodes and the current node.
AncestorsAndSelf(String)	Gets all anscestor nodes and the current node with matching name.
DescendantNodes	Gets all Descendant nodes for this node and each of child nodes
DescendantNodesAndSelf	Returns a collection of all descendant nodes of this element, in document order
Descendants()	Gets all Descendant nodes in enumerated list
Descendants(String)	Get all descendant nodes with matching name
DescendantsAndSelf()	Returns a collection of all descendant nodes of this element, in document order
DescendantsAndSelf(String)	Gets all descendant nodes including this node
Element	Gets first generation child node matching name
Elements	Gets matching first generation child nodes matching name

public HtmlNodeCollection ChildNodes { get; }

获取节点的所有子节点。ChildNodes是HtmlAgilityPack.HtmlNode 的成员

以下示例显示节点的所有子元素。

var htmlDoc = new HtmlDocument();
htmlDoc.LoadHtml(html);

var htmlBody = htmlDoc.DocumentNode.SelectSingleNode("//body");

HtmlNodeCollection childNodes = htmlBody.ChildNodes;

foreach (var node in childNodes)
{
    if (node.NodeType == HtmlNodeType.Element)
    {
        Console.WriteLine(node.OuterHtml);
    }
}

public HtmlNode FirstChild { get; }

获取节点的第一个子节点。FirstChild是HtmlAgilityPack.HtmlNode 的成员

以下示例显示节点的第一个子节点。

var htmlDoc = new HtmlDocument();
htmlDoc.LoadHtml(html);

var htmlNodes = htmlDoc.DocumentNode.SelectNodes("//body");

var htmlBody = htmlDoc.DocumentNode.SelectSingleNode("//body");

HtmlNode firstChild = htmlBody.FirstChild;

Console.WriteLine(firstChild.OuterHtml);

public HtmlNode LastChild { get; }

获取节点的最后一个子节点。LastChild是HtmlAgilityPack.HtmlNode的成员

以下示例显示节点的最后一个子节点。

var htmlDoc = new HtmlDocument();
htmlDoc.LoadHtml(html);

var htmlNodes = htmlDoc.DocumentNode.SelectNodes("//body");

var htmlBody = htmlDoc.DocumentNode.SelectSingleNode("//body");

HtmlNode lastChild = htmlBody.LastChild;

Console.WriteLine(lastChild.OuterHtml);

public HtmlNode NextSibling { get; }

获取紧跟在此元素后面的HTML节点。 NextSibling是HtmlAgilityPack.HtmlNode 的成员

以下示例显示下一个兄弟节点。

var htmlDoc = new HtmlDocument();
htmlDoc.LoadHtml(html);

var node = htmlDoc.DocumentNode.SelectSingleNode("//body/h1");

HtmlNode sibling = node.NextSibling;

while (sibling != null)
{
    if(sibling.NodeType == HtmlNodeType.Element)
        Console.WriteLine(sibling.OuterHtml);

    sibling = sibling.NextSibling;
}

public IEnumerable < HtmlNode > Ancestors()

获取节点的所有祖先。Ancestors方法是HtmlAgilityPack.HtmlNode的成员

返回此元素的所有祖先节点的集合。

以下示例显示所有祖先的名称。

var htmlDoc = new HtmlDocument();
htmlDoc.LoadHtml(html);

var node = htmlDoc.DocumentNode.SelectSingleNode("//b");

foreach (var nNode in node.Ancestors())
{
    if (nNode.NodeType == HtmlNodeType.Element)
    {
        Console.WriteLine(nNode.Name);
    }
}

public `IEnumerable<HtmlNode>` Ancestors(string name)

获取具有匹配名称的祖先。 Ancestors方法是HtmlAgilityPack.HtmlNode 的成员

参数：

返回具有匹配名称的此元素的所有祖先节点的集合。

以下示例显示具有匹配名称的祖先的名称。

var htmlDoc = new HtmlDocument();
htmlDoc.LoadHtml(html);

var node = htmlDoc.DocumentNode.SelectSingleNode("//b");

foreach (var nNode in node.Ancestors("body"))
{
    if (nNode.NodeType == HtmlNodeType.Element)
    {
        Console.WriteLine("Node name: " + nNode.Name);
        Console.WriteLine(nNode.InnerText);
    } 
}

public `IEnumerable<HtmlNode>` AncestorsAndSelf()

获取节点的所有祖先和节点本身。 AncestorsAndSelf方法是HtmlAgilityPack.HtmlNode 的成员

还返回所有祖先节点和节点本身的集合。

例子

以下示例显示所选节点及其所有祖先的名称。

var htmlDoc = new HtmlDocument();
htmlDoc.LoadHtml(html);

var node = htmlDoc.DocumentNode.SelectSingleNode("//u");

 foreach (var nNode in node.AncestorsAndSelf())
 {
     if (nNode.NodeType == HtmlNodeType.Element)
     {
         Console.WriteLine(nNode.Name);
     }
 }

public `IEnumerable<HtmlNode>` AncestorsAndSelf(string name)

获取具有匹配名称的祖先和节点本身。AncestorsAndSelf方法是HtmlAgilityPack.HtmlNode的成员

参数：

返回所有祖先节点和节点本身的名称匹配的集合。

以下示例显示所选节点及其所有具有匹配名称的祖先的名称

var htmlDoc = new HtmlDocument();
htmlDoc.LoadHtml(html);

var node = htmlDoc.DocumentNode.SelectSingleNode("//u");

foreach (var nNode in node.AncestorsAndSelf("p"))
{
    if (nNode.NodeType == HtmlNodeType.Element)
    {
        Console.WriteLine(nNode.Name);
    }
}

public `IEnumerable<HtmlNode>` DescendantNodes([int level = 0])

获取此节点和每个子节点的所有后代节点。DescendantNodes方法是HtmlAgilityPack.HtmlNode的成员

参数：

level：要在html树中解析的节点的深度级别。

返回此元素的所有后代节点的集合。

例子

以下示例显示所有后代节点的名称。

var htmlDoc = new HtmlDocument();
htmlDoc.LoadHtml(html);

var node = htmlDoc.DocumentNode.SelectSingleNode("//body");

foreach (var nNode in node.DescendantNodes())
{
    if (nNode.NodeType == HtmlNodeType.Element)
    {
        Console.WriteLine(nNode.Name);
    }
}

public `IEnumerable<HtmlNode>` DescendantNodesAndSelf([int level = 0])

以文档顺序获取此元素的所有后代节点的集合。 DescendantNodesAndSelf方法是HtmlAgilityPack.HtmlNode的成员

以文档顺序返回此元素的所有后代节点的集合。

以下示例显示所有后代节点的名称和节点本身。

var htmlDoc = new HtmlDocument();
htmlDoc.LoadHtml(html);

var node = htmlDoc.DocumentNode.SelectSingleNode("//body");

foreach (var nNode in node.DescendantNodesAndSelf())
{
    if (nNode.NodeType == HtmlNodeType.Element)
    {
        Console.WriteLine(nNode.Name);
    }
}

public `IEnumerable<HtmlNode>` Descendants([int level = 0])

获取枚举列表中的所有后代节点。Descendants是* HtmlAgilityPack.HtmlNode *的成员

参数：

level: 要在html树中解析的节点的深度级别。

返回此元素的所有后代节点的集合。

以下示例显示所有后代节点的名称。

var htmlDoc = new HtmlDocument();
htmlDoc.LoadHtml(html);

var node = htmlDoc.DocumentNode.SelectSingleNode("//body");

foreach (var nNode in node.Descendants())
{
    if (nNode.NodeType == HtmlNodeType.Element)
    {
        Console.WriteLine(nNode.Name);
    }
}

public `IEnumerable<HtmlNode>` Descendants(string name)

获取所有具有匹配名称的后代节点。Descendants是HtmlAgilityPack.HtmlNode的成员

参数：

返回名称匹配的所有后代节点的集合。

以下示例显示所有具有匹配名称的后代节点的名称。

var htmlDoc = new HtmlDocument();
htmlDoc.LoadHtml(html);

var node = htmlDoc.DocumentNode.SelectSingleNode("//body");

foreach (var nNode in node.Descendants("h2"))
{
    if (nNode.NodeType == HtmlNodeType.Element)
    {
        Console.WriteLine(nNode.Name);
    }
}

public `IEnumerable<HtmlNode>` DescendantsAndSelf()

以文档顺序获取此元素的所有后代节点的集合。 DescendantsAndSelf方法是HtmlAgilityPack.HtmlNode的成员

以文档顺序返回此元素的所有后代节点的集合。

以下示例显示所有后代的名称和节点本身。

var htmlDoc = new HtmlDocument();
htmlDoc.LoadHtml(html);

var node = htmlDoc.DocumentNode.SelectSingleNode("//body");

foreach (var nNode in node.DescendantsAndSelf())
{
    if (nNode.NodeType == HtmlNodeType.Element)
    {
        Console.WriteLine(nNode.Name);
    }
}

public IEnumerable < HtmlNode > DescendantsAndSelf(string name)

获取所有具有匹配名称的后代节点和节点本身。 DescendantsAndSelf是HtmlAgilityPack.HtmlNode 的成员

参数：

返回具有匹配名称的所有后代和节点本身的集合。

以下示例显示所有具有匹配名称的后代节点的名称以及节点本身。

var htmlDoc = new HtmlDocument();
htmlDoc.LoadHtml(html);

var node = htmlDoc.DocumentNode.SelectSingleNode("//body");

foreach (var nNode in node.DescendantsAndSelf("h2"))
{
    if (nNode.NodeType == HtmlNodeType.Element)
    {
        Console.WriteLine(nNode.OuterHtml);
    }
}

public HtmlNode Element(string name)

获取具有匹配名称的第一代子节点。 Element方法是HtmlAgilityPack.HtmlNode的成员

参数：

返回具有匹配名称的第一代子节点。

以下示例显示具有匹配名称的第一代子节点。

var htmlDoc = new HtmlDocument();
htmlDoc.LoadHtml(html);

var htmlBody = htmlDoc.DocumentNode.SelectSingleNode("//body");

var node = htmlBody.Element("p");

Console.WriteLine(node.OuterHtml);

public IEnumerable < HtmlNode > Elements(string name)

获取具有匹配名称的第一代子节点。Elements方法是HtmlAgilityPack.HtmlNode 的成员

参数：

返回具有匹配名称的第一代子节点的集合。

以下示例显示具有匹配名称的第一代子节点。

var htmlDoc = new HtmlDocument();
htmlDoc.LoadHtml(html);

var htmlBody = htmlDoc.DocumentNode.SelectSingleNode("//body");

var nodes = htmlBody.Elements("h2");

foreach (var node in nodes)
{
    if (node.NodeType == HtmlNodeType.Element)
    {
        Console.WriteLine(node.OuterHtml);
    }
}