C# 中的輕鬆 HTML 到 PDF 轉換 - Web 到 PDF 轉換器

對高效能文件管理解決方案的需求持續呈指數級增長。在本文中，我們深入探討了利用 .NET Cloud API 進行 HTML 到 PDF 轉換的好處和實際應用。從簡化工作流程到確保跨各種平台的兼容性，了解此功能如何顯著提高生產力並簡化文件管理任務。

本文涵蓋以下主題：

• HTML 到 PDF 轉換 API
• 使用 C# .NET 將 HTML 轉換為 PDF
• 使用 cURL 指令將 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. 建立「Configuration」類別的實例，我們在其中傳遞客戶端憑證作為參數。

var configurations = new Configuration(clientId, clientSecret1);

2. 初始化 ConvertApi，我們將 Configuration 物件作為輸入參數傳遞。

var apiInstance = new ConvertApi(configurations);

3. 將輸入 HTML 文件上傳到雲端存儲，我們在其中提供輸入 HTML 文件的名稱。

fileUpload.UploadFile(new UploadFileRequest("input.html", stream));

4. 建立一個實例“ConvertSettings”，在其中指定輸入 HTML 的名稱、輸出格式“pdf”以及產生的 PDF 文件的名稱。

var settings = new ConvertSettings{...}

5. 呼叫ConvertDocumentRequest介面將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 !");
    }
}

上例中產生的 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 to PDF Converter。它是免費、輕量級、超高效的，並提供強大的 HTML 到 PDF 轉換。

有用的連結

• 產品文件

• API源碼

• 免費支援論壇

結論

我們了解到，GroupDocs.Conversion Cloud 為文件轉換任務提供了無縫、高效且可靠的解決方案，使您能夠簡化工作流程並提高工作效率。因此，透過自動化轉換流程並確保結果的一致性和準確性，GroupDocs.Conversion Cloud API 簡化了複雜的任務並節省了寶貴的時間和資源。因此，無論您是希望將文件轉換功能整合到應用程式中的開發人員，還是希望優化文件管理流程的企業，我們的 API 都可以為您提供成功所需的工具。

相關文章

我們強烈建議訪問以下連結以了解更多資訊：

• 在 C# .NET 中將 Markdown 轉換為 PDF
• 在 C# .NET 中將 PNG 轉換為 PPTX
• 在 C# .NET 中將 Word 轉換為 Markdown