在使用C#处理HTML文档时，按元素ID修改内容是常见的需求，HTML Agility Pack作为轻量高效的HTML解析库，能轻松实现节点定位和内容替换操作，不需要依赖浏览器环境，适合服务端批量处理场景。
准备HTML Agility Pack环境
首先需要在项目中安装HTML Agility Pack包，如果你使用NuGet包管理器，直接在搜索栏输入HtmlAgilityPack安装即可，也可以通过Package Manager Console执行以下命令安装：
// 在NuGet包管理器控制台执行安装命令 Install-Package HtmlAgilityPack
核心实现步骤
整个修改流程分为三步，逻辑清晰容易上手：
- 加载目标HTML文档，可以是本地文件内容或者字符串形式的HTML
- 通过SelectSingleNode方法结合XPath语法，根据元素ID定位到目标节点
- 修改目标节点的InnerHtml或者属性值，最后保存修改后的文档
完整代码示例
下面是一段完整的示例代码，演示如何按ID修改HTML元素内容，代码中包含详细注释：
using HtmlAgilityPack;
using System;
using System.IO;
class HtmlModifier
{
static void Main()
{
// 原始HTML字符串，包含一个id为target的div元素
string originalHtml = @"<!DOCTYPE html>
<html>
<head>
<title>测试页面</title>
</head>
<body>
<div id=""target"">原始内容</div>
<p id=""other"">其他内容</p>
</body>
</html>";
// 创建HtmlDocument实例并加载HTML
HtmlDocument doc = new HtmlDocument();
doc.LoadHtml(originalHtml);
// 通过XPath语法按ID定位元素，html中id属性唯一，用SelectSingleNode即可
// XPath语法：//node[@id='目标id']，这里定位id为target的div
HtmlNode targetNode = doc.DocumentNode.SelectSingleNode("//div[@id='target']");
if (targetNode != null)
{
// 修改元素的内部文本/HTML内容，这里设置为新的文本内容
targetNode.InnerHtml = "这是修改后的新内容";
// 如果需要修改元素属性，比如class，可以这样操作
// targetNode.SetAttributeValue("class", "new-class");
Console.WriteLine("元素修改成功");
}
else
{
Console.WriteLine("未找到对应ID的元素");
}
// 获取修改后的HTML字符串
string modifiedHtml = doc.DocumentNode.OuterHtml;
Console.WriteLine("修改后的HTML：");
Console.WriteLine(modifiedHtml);
// 如果需要保存到文件，取消下面代码的注释即可
// File.WriteAllText("modified.html", modifiedHtml);
}
}注意事项
实际使用中需要注意几个点：
- XPath查询时元素ID需要完全匹配，区分大小写，否则会定位失败
- 如果页面中有多个相同ID的元素，SelectSingleNode只会返回第一个匹配的节点，需提前确认HTML结构是否符合规范
- 修改InnerHtml时如果传入包含HTML标签的内容，会被解析为实际节点，若只需要纯文本可以修改InnerText属性
- 处理外部获取的HTML时，建议先检查文档加载是否成功，避免出现空引用异常
适用场景
这个方法可以应用在多个场景中，比如服务端批量生成定制化HTML模板、爬虫爬取数据后替换页面中的冗余内容、自动化测试时修改页面节点内容验证功能等，相比使用正则匹配修改内容，这种方式更稳定，不会破坏原有的HTML结构。
C#HTML_Agility_PackHTML元素修改.NET爬虫修改时间：2026-06-06 00:30:25