使用 C# 解析、编辑和转换 HTML

Aspose.HTML for .NET 是用于在 C# 应用程序中处理 HTML 内容的类库。 HTMLDocument 类可从文件、URL、字符串或流中加载 HTML,并通过符合标准的 DOM 提供文档访问。应用程序可以查找和编辑元素,处理 CSS、SVG 与 HTML Canvas,还可以使用 Converter 类生成 PDF、XPS、DOCX 和栅格图像文件。该 API 还支持 XHTML、MHTML、EPUB 和 Markdown。

选择要执行的 HTML 任务

请选择与应用程序相符的任务。每份指南都会说明相关 API 类,提供针对性的 C# 示例,并链接到详细文档和 API Reference 页面。





安装 Aspose.HTML for .NET

将 Aspose.HTML NuGet 包 添加到 .NET 项目中。该包提供本站示例和指南所需的 HTML DOM、CSS、呈现、转换及文档处理命名空间。

使用 .NET CLI 安装 Aspose.HTML



dotnet add package Aspose.HTML


如何使用 C# 查找 HTML 元素

使用 HTMLDocument 加载 HTML 文件,通过 QuerySelectorAll() 查找匹配元素,然后从 DOM 中读取每个结果。该示例显式使用 Aspose.HTML for .NET 类型,安装 NuGet 包后即可在控制台应用程序中运行。

使用 C# 查找 HTML 元素



using Aspose.Html;
using Aspose.Html.Collections;
using Aspose.Html.Dom;

// Load the HTML document
using HTMLDocument document = new HTMLDocument("input.html");

// Select every link in the document
NodeList links = document.QuerySelectorAll("a");

foreach (Element link in links)
{
    Console.WriteLine($"{link.TextContent}: {link.GetAttribute("href")}");
}


QuerySelectorAll("a") 按文档顺序返回包含所有匹配 <a> 元素的 NodeList。如果只需要第一个匹配元素,请使用 QuerySelector();如果需要 XPath 表达式,请使用 XPath 查询 。

支持的网页格式和输出类型

输入或文档类型可用操作
HTML 和 XHTML解析、创建、编辑、导航、合并、转换和呈现
MHTML 和 MHT加载、转换、呈现和合并归档文件,并创建更新后的归档文件
EPUB加载出版物、合并内容,并呈现为固定布局格式或图像
Markdown解析、创建、编辑、转换为 HTML,并通过 HTML 文档进行呈现
SVG加载、检查、编辑和转换矢量内容

根据源格式,转换流程可以生成 PDF、XPS、DOCX、TIFF、PNG、JPEG、BMP 和 GIF 文件。请阅读 格式之间的转换 ,了解如何选择正确的 Converter 方法和保存选项类。

HTML API 类和开发者资源

  • HTMLDocument 表示已加载或新创建的 HTML 文档,并提供对 DOM 的访问。
  • QuerySelector() 和 QuerySelectorAll() 使用 CSS 选择器查找元素。
  • Converter 提供用于转换 HTML、XHTML、MHTML、EPUB、Markdown 和 SVG 的静态方法。
  • PdfSaveOptions 、DocSaveOptions、ImageSaveOptions 和 XpsSaveOptions 用于配置不同格式的输出。

请从 入门指南 开始,查看完整的 Aspose.HTML for .NET API Reference ,或运行 Aspose.HTML for .NET GitHub 存储库 中的示例。

常见问题

1. 在 C# 中加载 HTML 文档后可以执行哪些操作?

将 HTML 加载到 HTMLDocument 后,可以检查 DOM,使用 CSS 选择器或 XPath 查找元素,修改内容和属性,添加或删除节点,然后保存或转换更新后的文档。

2. 转换为 PDF 或图像之前可以修改 HTML 吗?

可以。将源内容加载到 HTMLDocument,修改 DOM、CSS 或链接内容,然后将更新后的文档传递给所需的转换方法。生成的 PDF、XPS、DOCX 或图像文件会包含这些修改。

3. 加载 HTML 时如何解析 CSS、图像和字体的相对 URL?

资源的相对 URL 根据文档地址或加载 HTML 时提供的基准 URL 进行解析。当标记来自字符串或流并引用外部资源时,正确的基准 URL 尤为重要。

4. 转换 HTML、MHTML、EPUB、Markdown 或 SVG 应使用哪个 API 方法?

请使用与源格式对应的 Converter 类方法,例如 ConvertHTML()、ConvertMHTML()、ConvertEPUB()、ConvertMarkdown() 或 ConvertSVG()。保存选项类决定输出格式和转换设置。



  

Support and Learning Resources

  
  

Aspose.HTML 还为其他常用开发平台提供 HTML 处理 API。