将 HTML 文件或网页转换为 PDF 是文档、归档、打印或内容共享的常见需求。PDF 在各个平台上提供一致的布局和格式。在本文中,您将学习如何使用 Aspose.PDF Cloud SDK for .NET 在 C# 中将 HTML 转换为 PDF,这是一种强大且可扩展的 REST API 解决方案,用于文档自动化。
Web to PDF 转换 API
Aspose.PDF Cloud SDK for .NET 使得将 HTML 文件或在线网页转换成高质量、分页的 PDF 文档变得容易。它支持加载带有链接资源的 HTML 内容,例如 CSS、JavaScript 和图像。
API 的关键特性:
- 将 HTML 文件和 URL 转换为 PDF 格式
- 支持外部资源 (CSS, JS, 图片)
- 基于 REST API 且平台无关
- 自定义页面设置、边距和渲染选项
安装 .NET REST API:
使用 NuGet 将 SDK 安装到您的 .NET 应用程序中:
Install-Package Aspose.PDF-Cloud
在 Aspose Cloud Dashboard 注册以获取您的客户端 ID 和客户端密钥。
将 HTML 转换为 PDF 在 C# 中
以下步骤展示了如何使用 C# 将 HTML 文件转换为 PDF:
- 首先,创建一个
Configuration
的实例,在其中传入客户端凭据。- 其次,初始化一个
PdfApi
对象,同时传递 Configuration 对象。- 第三,创建一个
GetHtmlInStorageToPdf
的对象,在这里我们定义结果 PDF 的属性。- 最后,我们调用客户方法
saveToDisk
进行 HTML 到 PDF 的转换。
// 对于更多示例, https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet/tree/master/Examples
// 从 https://dashboard.aspose.cloud/ 获取客户端凭据。
string clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
string clientID = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
// 创建 PdfApi 的实例
PdfApi pdfApi = new PdfApi(clientSecret, clientID);
// 输入 HTML 文件名
String inputHTML = "input1.html";
// 调用 API 以转换云存储中的 .zip 存档中的 HTML。
// 我们还指定了要转换的 HTML 文件的名称以及边距详情。
var result = pdfApi.GetHtmlInStorageToPdf("inputHTML.zip",htmlFileName: inputHTML,
height: 1000, width: 800, isLandscape: false,
marginLeft: 10, marginRight: 10, marginTop: 10, marginBottom: 10);
// 调用方法将输出保存到本地驱动器
saveToDisk(result, "/Users/nayyer/Downloads/Converted.pdf");
// 将流内容保存到本地驱动器文件的方法
public static void saveToDisk(Stream responseStream, String resultantFile)
{
var fileStream = File.Create(resultantFile);
responseStream.Seek(0, SeekOrigin.Begin);
responseStream.CopyTo(fileStream);
fileStream.Close();
}

Image:- JPG 转 PDF 转换预览。
使用 cURL 将网页转换为 PDF
如果您更喜欢直接使用 REST API?以下是如何使用 cURL 将 HTML 文件转换为 PDF。
- 获取访问令牌:
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
- 从 HTML 创建 PDF:
curl -v "https://api.aspose.cloud/v3.0/pdf/{resultantFile}/create/html?srcPath=converted.zip&htmlFileName={sourceHTML}" \
-X PUT \
-H "accept: application/json" \
-H "authorization: Bearer {ACCESS_TOKEN}" \
-d {} -v
将 {ACCESSTOKEN}
和 sourceHTML
替换为您在云存储中的实际令牌和 HTML 路径。
尝试在线将 HTML 转换为 PDF
如果您想在没有代码的情况下测试 HTML 到 PDF 的转换,可以尝试使用我们的免费 HTML to PDF Online Converter 立即在您的浏览器中体验。

免费 HTML 到 PDF 转换器应用程序。
结论
使用 Aspose.PDF Cloud SDK for .NET,您可以可靠地将 HTML 和 web 内容转换为 PDF,只需最少的努力。无论您是在构建 web 报告、导出 CMS 内容,还是生成可打印的档案,该 SDK 允许在您的 .NET 应用程序中实现无缝自动化。
有用的链接
相关的文章
我们强烈建议访问以下博客文章以获取信息: