
تبدیل کننده آنلاین HTML به PDF با C# .NET.
تبدیل HTML به PDF برای اشتراکگذاری، چاپ، بایگانی یا حفظ فرمت ضروری است. با استفاده از GroupDocs.Conversion Cloud SDK برای .NET، میتوانید تبدیلهای باکیفیت HTML به PDF را بدون وابستگی به پلاگینهای مرورگر یا ابزارهای خارجی انجام دهید.
در این مقاله، شما یاد خواهید گرفت که چگونه:
API تبدیل HTML به PDF
GroupDocs.Conversion Cloud SDK for .NET یک API REST با کیفیت بالا و مقیاسپذیر است که قابلیتهای تبدیل HTML به PDF آنلاین را ارائه میدهد. این API اطمینان میدهد که فرمت محتوا شامل طراحی، چیدمان و رسانههای جاسازی شده در PDF حاصل حفظ میشود.
پیش نیازها
- یک محیط توسعه .NET (برای مثال، ویژوال استودیو)
- <GroupDocs.Conversion> Cloud SDK for .NET نصب شده از طریق
- شناسه مشتری و راز مشتری from GroupDocs Cloud
SDK را با استفاده از NuGet نصب کنید:
با استفاده از npm نصب کنید:
PM> NuGet\Install-Package GroupDocs.Conversion-Cloud
مرحله به مرحله: تبدیل HTML به PDF در C#
لطفاً مراحل زیر را برای انجام تبدیل رایگان HTML به PDF آنلاین با استفاده از C# .NET دنبال کنید:
📌 گام ۱: پیکربندی API را راه اندازی کنید:
var config = new Configuration
{
ClientId = "YOUR_CLIENT_ID",
ClientSecret = "YOUR_CLIENT_SECRET"
};
var convertApi = new ConvertApi(config);
var fileApi = new FileApi(config);
📌 مرحله ۲: بارگذاری فایل HTML به ذخیرهسازی ابری:
using (var fileStream = File.OpenRead("input.html"))
{
var uploadRequest = new UploadFileRequest("input.html", fileStream);
fileApi.UploadFile(uploadRequest);
}
📌 مرحله ۳: تنظیمات تبدیل را تعریف کنید و تبدیل کنید:
var settings = new ConvertSettings
{
FilePath = "input.html",
Format = "pdf",
OutputPath = "converted/output.pdf"
};
var request = new ConvertDocumentRequest(settings);
convertApi.ConvertDocument(request);
Console.WriteLine("✅ HTML file successfully converted to PDF.");
// بیشتر مثالها در https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet
// اعتبارنامه API خود را به دست آورید
string clientId = "4bdefca3-f08c-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "a43c8b4365246a062688a259abe5b469";
// یک نمونه از کلاس Configuration ایجاد کنید و آن را با شناسه مشتری (Client ID) و مخفینامه مشتری (Client Secret) مقداردهی اولیه کنید.
var configurations = new GroupDocs.Conversion.Cloud.Sdk.Client.Configuration(clientId, clientSecret1);
// Define the value of ApiBaseUrl to set the base url of the html to PDF converter API.
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
// یک نمونه از کلاس ConvertApi را با شیء کلاس Configuration مقداردهی اولیه کنید.
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));
// create ConvertSettings where we define the input HTML and name for resultant 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"))
{
// print succeess message
Console.WriteLine("HTMl to PDF conversion completed successfully !");
}
}
تصویر:- پیش نمایش تبدیل HTML به PDF.
فایل PDF نمونه تولید شده در مثال بالا را از resultant.pdf دانلود کنید.
گزینهای: تبدیل HTML به PDF با cURL
اگر شما به استفاده از ابزارهای خط فرمان یا لولههای اتوماسیون ترجیح میدهید، GroupDocs.Conversion Cloud نیز میتواند از طریق cURL قابل دسترسی است.
- این روش برای خطوط اتوماسیون و تبدیلهای مبتنی بر اسکریپت ایدهآل است.
مرحله 1: دریافت توکن دسترسی JWT
curl -v "https://api.groupdocs.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"
مرحله 2: تبدیل HTML به PDF
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\": \"default\", \"FilePath\": \"{sourcePDF}\", \"Format\": \"html\", \"OutputPath\": \"{finalOutput}\"}"
Replace:
- sourceFile، resultantFile و accessToken با مقادیر واقعی.
- اکنون برای ذخیره PDF در درایو محلی، میتوانید از دستور 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\": \"default\", \"FilePath\": \"{sourceFile}\", \"Format\": \"html\"}" \
-o "myOutput.html"
نسخه رایگان مبدل HTML به PDF را آنلاین امتحان کنید
آیا به یک راه حل سریع و بدون کد نیاز دارید؟ از HTML to PDF Converter برای تبدیل محتوای وب به سرعت استفاده کنید.

نتیجهگیری
با کمک GroupDocs.Conversion Cloud SDK برای .NET، میتوانید بهطور یکپارچه HTML را به PDF در برنامههای C# خود تبدیل کنید. چه برای صادرات سند، تولید گزارش یا بایگانی محتوای وب استایلشده، این API انعطافپذیری و کنترل کامل را ارائه میدهد.
منابع مفید
مقالات مرتبط
ما پیشنهاد میکنیم مقالات زیر را بررسی کنید: