在 C# .NET 中将 HTML 转换为 PDF

对高效文档管理解决方案的需求持续呈指数级增长。在本文中，我们深入探讨了利用 .NET Cloud API 进行 HTML 到 PDF 转换的好处和实际应用。从简化工作流程到确保跨各种平台的兼容性，了解此功能如何显著提高生产力并简化文档管理任务。

本文涵盖以下主题：

HTML 到 PDF 转换 API

我们将探索 GroupDocs.Conversion Cloud SDK for .NET 的强大功能及其在无缝完成 HTML 到 PDF 转换要求方面的关键作用。随着企业和开发人员寻求高效的文档管理解决方案，此 API 成为一种强大的工具，提供无与伦比的易用性和多功能性。让我们深入研究此转换 SDK 如何帮助您轻松地将 HTML 文件转换为 PDF 格式，从而促进更顺畅的工作流程并提高生产力。

现在，为了使用 SDK，第一步是安装它。只需在 NuGet 包管理器中搜索 GroupDocs.Conversion-Cloud 并单击“安装”按钮。另一个选项是在包管理器控制台中执行以下命令。

NuGet\Install-Package GroupDocs.Conversion-Cloud -Version 24.2.0

成功安装 REST API 后，请确保您拥有 API 凭证(即客户端 ID 和客户端密钥)。您可以访问这个简短的 教程 来了解如何获取 API 凭证。

使用 C# .NET 将 HTML 转换为 PDF

在本节中，我们将探讨如何使用 C# .NET 以编程方式将 HTML 转换为 PDF 的详细信息。

  1. 创建“配置”类的实例，我们将客户端凭据作为参数传递。
var configurations = new Configuration(clientId, clientSecret1);
  1. 初始化“ConvertApi”，我们将配置对象作为输入参数传递。
var apiInstance = new ConvertApi(configurations);
  1. 将输入的 HTML 文件上传到云存储，我们在那里提供输入 HTML 文件的名称。
fileUpload.UploadFile(new UploadFileRequest("input.html", stream));
  1. 创建一个实例“ConvertSettings”，其中我们指定输入 HTML 的名称、输出格式为“pdf”以及结果 PDF 文档的名称。
var settings = new ConvertSettings{...}
  1. 调用ConvertDocumentRequest API将HTML转换为PDF格式，转换成功后PDF文件保存在云存储中。
var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));

// 更多示例请访问 https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet
// 获取您的 API 凭证 
string clientId = "4bdefca3-f08c-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "a43c8b4365246a062688a259abe5b469";

// 创建配置类的实例，并使用客户端 ID 和客户端密钥对其进行初始化。 
var configurations = new GroupDocs.Conversion.Cloud.Sdk.Client.Configuration(clientId, clientSecret1);
// 定义 ApiBaseUrl 的值来设置 html 到 PDF 转换器 API 的基本 URL。
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

// 使用 Configuration 类的对象初始化 ConvertApi 类的实例。
var apiInstance = new GroupDocs.Conversion.Cloud.Sdk.Api.ConvertApi(configurations);
             
// 从本地驱动器加载 HTML 文件             
using (var stream = System.IO.File.OpenRead("converted.html"))
{
    // 创建 FileApi 实例
    var fileUpload = new FileApi(configurations);
    // 将输入的 HTML 文件上传至云存储
    fileUpload.UploadFile(new UploadFileRequest("input.html", stream));

    // 创建 ConvertSettings，在其中定义输入 HTML 和结果 PDF 的名称
    var settings = new ConvertSettings
    {
        StorageName = "internal",
        FilePath = "input.html",
        Format = "pdf",
        OutputPath = "resultant.pdf"
    };
    
    // 调用 ConvertDocument 方法以编程方式将 HTML 转换为 PDF。
    var response = apiInstance.ConvertDocument(new GroupDocs.Conversion.Cloud.Sdk.Model.Requests.ConvertDocumentRequest(settings));
    if (response != null && response.Equals("OK"))
    {
        // 打印成功信息
        Console.WriteLine("HTMl to PDF conversion completed successfully !");
    }
}
HTML 到 PDF 转换的预览。

图像：- HTML 到 PDF 转换的预览。

上述示例中生成的示例 PDF 可以从 resultant.pdf 下载。

使用 cURL 命令将 HTML 转换为 PDF

将 HTML 转换为 PDF 的另一种方法是结合使用 GroupDocs.Conversion Cloud 和 cURL 命令。使用 GroupDocs.Conversion Cloud 通过 cURL 命令将 HTML 转换为 PDF 具有几个显著的好处，例如，它提供了一种将 HTML 文件转换为 PDF 格式的无缝且直接的方法，无需复杂的手动流程。因此，通过利用 GroupDocs.Conversion Cloud API，用户可以自动化转换过程，从而节省重复任务的时间和精力。

确保您已从 GroupDocs 仪表板获取 API 凭据(应用密钥和应用 SID)并生成 JWT 访问令牌。获得 JWT 令牌后，请执行以下 cURL 命令，我们还提供了在此转换过程中要添加的文本水印的属性。

curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{  \"StorageName\": \"internal\",  \"FilePath\": \"{sourceFile}\",  \"Format\": \"pdf\",  \"LoadOptions\": {    \"Format\": \"html\"  },  \"ConvertOptions\": {    \"FromPage\": 1,    \"PagesCount\": 1,    \"Pages\": [      1    ],    \"WatermarkOptions\": {      \"Text\": \"GroupDocs.Cloud\",      \"FontName\": \"Arial\",      \"FontSize\": 4,      \"Bold\": false,      \"Italic\": true,      \"Color\": \"olive\",      \"Width\": 10,      \"Height\": 6,      \"Top\": 100,      \"Left\": 100,      \"RotationAngle\": 10,      \"Transparency\": 0.8,      \"Background\": true,      \"AutoAlign\": true    }  },  \"OutputPath\": \"{converted}\"}"

请将“sourceFile”替换为输入 HTML 文件的名称，将“resultantFile”替换为要生成的输出 PDF 格式的名称，并将“accessToken”替换为上面生成的 JWT 令牌。

免费 HTML 到 PDF 转换应用程序

基于 GroupDocs.Conversion Cloud API，我们开发了在线 HTML 到 PDF 转换器。它免费、轻量、超高效，并提供强大的 HTML 到 PDF 转换功能。

免费 html 转 pdf 应用程序

有用的链接

— 产品文档

-API源代码

-免费支持论坛

结论

我们了解到，GroupDocs.Conversion Cloud 为文档转换任务提供了无缝、高效且可靠的解决方案，使您能够简化工作流程并提高工作效率。因此，通过自动化转换过程并确保结果的一致性和准确性，GroupDocs.Conversion Cloud API 简化了复杂的任务并节省了宝贵的时间和资源。因此，无论您是希望将文档转换功能集成到应用程序中的开发人员，还是寻求优化文档管理流程的企业，我们的 API 都能为您提供成功所需的工具。

相关文章

我们强烈建议您访问以下链接以了解更多信息：