تبدیل HTML به PDF در C#.NET

تقاضا برای راه حل های کارآمد مدیریت اسناد همچنان به طور تصاعدی در حال رشد است. در این مقاله، به مزایا و کاربردهای عملی استفاده از API .NET Cloud برای تبدیل HTML به PDF می پردازیم. از ساده‌سازی گردش‌های کاری گرفته تا اطمینان از سازگاری در پلتفرم‌های مختلف، کشف کنید که چگونه این ویژگی می‌تواند بهره‌وری را به میزان قابل توجهی افزایش دهد و وظایف مدیریت اسناد را ساده‌تر کند.

این مقاله موضوعات زیر را پوشش می دهد:

API تبدیل HTML به PDF

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

حال برای استفاده از SDK اولین قدم نصب آن است. کافی است GroupDocs.Conversion-Cloud را در NuGet Package Manager جستجو کنید و روی دکمه Install کلیک کنید. گزینه دیگر این است که دستور زیر را در کنسول مدیریت بسته اجرا کنید.

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

هنگامی که REST API با موفقیت نصب شد، مطمئن شوید که اعتبار API (یعنی شناسه مشتری و Client Secret) را دارید. می توانید از این [آموزش] کوتاه 8 دیدن کنید تا نحوه دریافت اعتبارنامه API را ببینید.

تبدیل HTML به PDF با استفاده از C#.NET

در این بخش قصد داریم جزئیات نحوه تبدیل HTML به PDF را با استفاده از C#.NET به صورت برنامه نویسی بررسی کنیم.

  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» و نام سند پی‌دی‌اف حاصل را مشخص می‌کنیم.
var settings = new ConvertSettings{...}
  1. برای تبدیل HTML به فرمت PDF با ConvertDocumentRequest API تماس بگیرید. پس از تبدیل موفقیت آمیز، 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";

// یک نمونه از کلاس Configuration ایجاد کنید و آن را با Client ID & Client Secret مقداردهی کنید. 
var configurations = new GroupDocs.Conversion.Cloud.Sdk.Client.Configuration(clientId, clientSecret1);
// مقدار ApiBaseUrl را برای تنظیم url پایه API مبدل html به PDF تعریف کنید.
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));

    // 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 دانلود کرد.

HTML به PDF با استفاده از دستورات cURL

گزینه دیگر برای تبدیل HTML به PDF ترکیبی از دستورات GroupDocs.Conversion Cloud و cURL است. تبدیل HTML به PDF با استفاده از GroupDocs.Conversion Cloud از طریق دستورات cURL چندین مزیت قابل توجه را ارائه می دهد، از جمله، روشی یکپارچه و ساده برای تبدیل فایل های HTML به فرمت PDF، که نیاز به فرآیندهای پیچیده دستی را از بین می برد. بنابراین، با استفاده از GroupDocs.Conversion Cloud API، کاربران می توانند فرآیند تبدیل را به صورت خودکار انجام دهند و در زمان و تلاش برای کارهای تکراری صرفه جویی کنند.

اطمینان حاصل کنید که اعتبارنامه API (کلید برنامه و SID برنامه) خود را از داشبورد GroupDocs دریافت کرده اید و رمز دسترسی 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 Converter را توسعه داده ایم. این یک رایگان، سبک وزن، فوق العاده کارآمد است و تبدیل HTML به PDF قوی را ارائه می دهد.

برنامه رایگان html به pdf

لینک های مفید

نتیجه

ما آموخته ایم که GroupDocs.Conversion Cloud راه حلی یکپارچه، کارآمد و قابل اعتماد برای وظایف تبدیل سند ارائه می دهد که به شما امکان می دهد گردش کار خود را ساده کنید و بهره وری را افزایش دهید. بنابراین، با خودکار کردن فرآیند تبدیل و اطمینان از ثبات و دقت در نتایج، GroupDocs.Conversion Cloud API کارهای پیچیده را ساده می کند و در زمان و منابع ارزشمند صرفه جویی می کند. بنابراین، چه شما یک توسعه‌دهنده باشید که به دنبال ادغام قابلیت‌های تبدیل سند در برنامه‌های کاربردی خود هستید یا کسب‌وکاری که به دنبال بهینه‌سازی فرآیندهای مدیریت اسناد شماست، API‌های ما ابزارهایی را که برای موفقیت نیاز دارید فراهم می‌کنند.

مقالات مرتبط

توصیه می کنیم برای کسب اطلاعات بیشتر به لینک های زیر مراجعه کنید: