CsQuery 开源项目使用教程

2025-04-22 08:15:43作者：魏献源Searcher

1. 项目介绍

CsQuery 是一个基于 .NET 的 HTML5 解析库，它允许开发者在服务器端使用类似 jQuery 的语法解析和操作 HTML 文档。这个库能够解析 HTML，支持 CSS 选择器，并且可以轻松地读取和修改 DOM 元素，从而使得处理 HTML 文档变得更加高效和方便。

2. 项目快速启动

在开始使用 CsQuery 之前，请确保您的开发环境中已经安装了 .NET 环境。

安装 CsQuery

您可以通过 NuGet 包管理器安装 CsQuery：

Install-Package CsQuery

快速示例

以下是一个使用 CsQuery 的简单示例：

using CsQuery;

// 解析 HTML 字符串
var html = "<html><head><title>测试页面</title></head><body><div id='content'>Hello, World!</div></body></html>";
var cq = CQ.Create(html);

// 使用 CSS 选择器选择元素
var content = cq["#content"].Text();

// 输出内容
Console.WriteLine(content); // 输出: Hello, World!

3. 应用案例和最佳实践

案例一：网页内容抓取

您可以使用 CsQuery 来抓取网页内容，例如：

var web = new WebClient();
var html = web.DownloadString("http://example.com");
var cq = CQ.Create(html);

var articleTitle = cq["h1"].Text();
var articleContent = cq["#content"].Text();

Console.WriteLine(articleTitle);
Console.WriteLine(articleContent);

案例二：DOM 操作

CsQuery 支持丰富的 DOM 操作，例如：

var cq = CQ.Create("<div>Original Content</div>");

// 添加新元素
cq.Append("<p>New paragraph</p>");

// 修改元素
cq["div"].Text("Updated Content");

// 删除元素
cq["p"].Remove();

// 输出 HTML
Console.WriteLine(cq.Render());