在今天的數位環境中，HTML 是最常用於在線顯示和分享結構化數據的格式之一。然而，當涉及到檔案存檔、發佈或離線訪問時，PDF 仍然是首選格式。開發人員經常需要將 HTML 轉換為 PDF，以創建報告、發票或以通用相容格式保留網站內容。
這篇文章涵蓋以下主題：
HTML 轉 PDF 轉換 SDK
GroupDocs.Conversion Cloud SDK for .NET 提供了一個強大且可擴展的文件格式轉換解決方案。在使用此 API 的功能時，您可以無縫地將 HTML 轉換為 PDF，確保準確性、一致性和卓越的性能—所有這些都無需安裝額外的軟體。
開始進行 HTML 到 PDF 的轉換
在您開始之前，確保您具備以下先決條件：
- 一個 GroupDocs Cloud account 以獲取您的 Client ID 和 Client Secret。欲了解更多信息，請訪問簡短的 tutorial。
- 一個用於測試的示例 HTML 文件或網頁。
- 一個配置好的 .NET 開發環境(例如 Visual Studio 或 Rider)。
您可以通過運行以下命令從 NuGet 包管理器安裝 SDK：
Install-Package GroupDocs.Conversion-Cloud -Version 25.9.0
將 HTML 轉換為 PDF 使用 C#
讓我們探索如何使用 C# 和 GroupDocs Cloud SDK 以程式方式執行 HTML 到 PDF 的轉換。
- 創建
Configuration類的實例，並將客戶端憑證作為參數傳遞。
var configuration = new Configuration
{
AppSid = "YOUR_CLIENT_ID",
AppKey = "YOUR_CLIENT_SECRET"
};
- 初始化
ConvertApi和FileApi的實例，並將 Configuration 物件作為參數傳遞。
var convertApi = new ConvertApi(configuration);
var fileApi = new FileApi(configuration);
- 將輸入的 HTML 上傳到雲端存儲。
using (var stream = File.OpenRead("source.html"))
{
var uploadRequest = new UploadFileRequest("source.html", stream);
fileApi.UploadFile(uploadRequest);
}
- 創建一個
ConvertSettings的實例，其中我們指定輸入 HTML 的名稱、輸出格式為pdf和生成的 PDF 名稱。
var settings = new ConvertSettings
{
FilePath = "index.html",
Format = "pdf",
OutputPath = "converted/html-to-pdf-result.pdf"
};
- 呼叫 ConvertDocumentRequest API 將 HTML 轉換為 PDF 格式。轉換成功後，結果 PDF 將儲存在雲端儲存中。
var request = new ConvertDocumentRequest(settings);
convertApi.ConvertDocument(request);
一旦請求執行，您的 HTML 文件將被轉換為高品質的 PDF，並儲存在您雲端儲存中的指定輸出資料夾內。
HTML 轉 PDF 轉換使用 cURL
如果您更喜歡通過腳本或自動化管道進行轉換，cURL 是一個極好的替代方案。它允許您直接從命令行執行 REST API 調用，使其非常適合快速測試和批量處理。
為什麼使用 cURL 進行 HTML 到 PDF 的轉換？
- 不需要安裝 SDK。
- 適合用於殼程式、CI/CD 工作流程或後端服務。
- 輕巧且易於自動化。
在執行 HTML 轉換為 PDF 的命令之前，根據客戶端憑證生成您的 JWT 訪問令牌。當令牌生成後，請執行以下命令。
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"internal\", \"FilePath\": \"{sourceFile}\", \"Format\": \"pdf\", \"LoadOptions\": { \"Format\": \"html\" }, \"ConvertOptions\": { \"FromPage\": 1, \"PagesCount\": 1, \"Pages\": [ 1 ], \"WatermarkOptions\": { \"Text\": \"Confidential\", \"FontName\": \"Arial\", \"FontSize\": 12, \"Bold\": false, \"Italic\": true, \"Color\": \"Red\", \"Width\": 10, \"Height\": 6, \"Top\": 100, \"Left\": 100, \"RotationAngle\": 10, \"Transparency\": 0.8, \"Background\": true, \"AutoAlign\": true } }, \"OutputPath\": \"{converted}\"}"
將 {ACCESSTOKEN} 替換為您生成的 JWT 令牌，並將 index.html 替換為您的 HTML 文件名稱。
嘗試免費的 HTML 轉 PDF 轉換器
如果您想在不編寫任何代碼的情況下探索轉換過程，請嘗試免費的 HTML to PDF Converter 由 GroupDocs.Conversion Cloud 提供支持的網頁應用程式。它允許您上傳任何 HTML 文件或網址，並立即下載生成的 PDF。
有用的鏈接
結論
使用 .NET REST API 將 HTML 轉換為 PDF 為開發人員提供了一種可靠的方法，以便在便攜格式中保留網頁佈局、樣式和內容。通過 GroupDocs.Conversion Cloud SDK for .NET，您可以使用幾行代碼自動化此過程——無論您是需要轉換單個 HTML 文件還是整個網頁批次。
相關文章
我們強烈建議訪問以下鏈接以瞭解更多信息：
常見問題 (FAQs)
- 如何使用 C# .NET 將 HTML 轉換為 PDF？
- 您可以使用 GroupDocs.Conversion Cloud SDK for .NET 上傳 HTML 文件，將輸出格式配置為 PDF，並執行
ConvertDocument()方法以生成轉換後的文件。
- 這個 API 是否支持轉換 HTML 以及 CSS 和圖片？
- 是的。該 SDK 維護所有連結資源，確保您轉換的 PDF 準確保留佈局、字體、圖片和樣式。
- 我可以直接從網址轉換網頁嗎？
- 是的。您可以在輸入路徑中指定網頁 URL，API 將渲染 HTML 內容並將其轉換為 PDF 文檔。
- 我需要安裝任何第三方工具，如 Adobe Acrobat 嗎？
- 不。整個過程是基於雲端的—不需要本地安裝或額外軟體。