NET 的 HTML 转换器

Aspose.HTML Converter for .NET 是一个高性能的插件,允许开发人员转换 HTML 和 XHTML 多种格式的文件,包括 PDF、XPS 和图像文件. 旨在无缝集成,支持复杂的布局、外部资源和先进的播放选项,使其成为文档自动化、报告和网页打印工作流的必需工具.

安装和设置

  • 通过 NuGet 安装 Aspose.HTML 包或从 下载页面 .
  • 应用您的许可密钥,如适用,包括测量授权,以解锁完整的功能.
  • 引用 The Aspose.Html 您的项目中的名称.

兼容 .NET 框架、 .NET Core (2.0 至 3.1), .Net 5+ 和 .net 标准 2.0/2.1 . 在 Windows、macOS、Linux 环境中运行.

将 HTML 转换为 PDF

最常见的场景是将 HTML 转换为 PDF. 您可以设置加密、页面大小和边界等选项.

using Aspose.Html;
using Aspose.Html.Converters;
using Aspose.Html.Saving;

// Create an instance of HTMLDocument
var document = new HTMLDocument("developer-guide.html");
var options = new PdfSaveOptions();

// Convert HTML to PDF
Converter.ConvertHTML(document, options, "developer-guide.pdf");

此示例将 HTML 文件转换为 PDF 同时保留其布局.

将 HTML 转换为图像

您也可以将 HTML 内容转换为像 PNG 或 JPEG 这样的图像.

using Aspose.Html;
using Aspose.Html.Converters;
using Aspose.Html.Saving;

// Create an instance of HTMLDocument
var document = new HTMLDocument("developer-guide.html");
var options = new ImageSaveOptions(ImageFormat.Png);

// Convert HTML to PNG
Converter.ConvertHTML(document, options, "developer-guide.png");

此代码将 HTML 转换为 A PNG 图像可以在报告或档案中使用.

将 HTML 转换为 XPS

要从 HTML 中创建 XPS 文档:

using Aspose.Html;
using Aspose.Html.Converters;
using Aspose.Html.Saving;

// Create an instance of HTMLDocument
var document = new HTMLDocument("developer-guide.html");
var options = new XpsSaveOptions();

// Convert HTML to XPS
Converter.ConvertHTML(document, options, "developer-guide.xps");

错误处理例子

用 try-catch 轻松处理错误:

try
{
    var document = new HTMLDocument("developer-guide.html");
    var options = new PdfSaveOptions();
    Converter.ConvertHTML(document, options, "developer-guide.pdf");
}
catch (Exception ex)
{
    Console.WriteLine($"Error converting HTML: {ex.Message}");
}

主要特点

  • 多格式出口 :将HTML转换为PDF、XPS和图像.
  • Layout Fidelity :保存字体、CSS、图形和外部资源.
  • 先进的 PDF 选项 :支持 PDF/A 遵守、加密和代数据.
  • Cross-Platform :在Windows、Linux 和 macOS 上在 .NET 环境中工作.

最佳实践

  • 在应用初创时,始终使用许可钥匙以避免评估水标.
  • 可验证的外部资源(CSS、图像、字体)在转换前可访问.
  • 使用 PdfSaveOptions 或 ImageSaveOptions 以精致的品质和尺寸.
  • 对于大 HTML 文件,最好是基于流的转换,以减少记忆使用量.

通过整合 Aspose.HTML Converter for .NET ,开发人员可以有效地将 HTML 内容转化为专业级的 PDF、XPS 或图像输出,同时确保布局一致性和高性能.

 中文