تحويل HTML إلى PDF في C# .NET

يستمر الطلب على حلول إدارة المستندات الفعالة في النمو بشكل كبير. في هذه المقالة، نتعمق في الفوائد والتطبيقات العملية للاستفادة من .NET Cloud API لتحويل HTML إلى PDF. بدءًا من تبسيط سير العمل وحتى ضمان التوافق عبر الأنظمة الأساسية المختلفة، اكتشف كيف يمكن لهذه الميزة تحسين الإنتاجية بشكل كبير وتبسيط مهام إدارة المستندات.

تتناول هذه المقالة المواضيع التالية:

واجهة برمجة تطبيقات تحويل HTML إلى PDF

سنستكشف الإمكانات القوية لـ GroupDocs.Conversion Cloud SDK for .NET ودورها المحوري في إنجاز متطلبات تحويل HTML إلى PDF بسلاسة. نظرًا لأن الشركات والمطورين يبحثون عن حلول فعالة لإدارة المستندات، تظهر واجهة برمجة التطبيقات هذه كأداة قوية توفر سهولة وتنوعًا لا مثيل لهما. دعنا نتعمق في كيفية قيام SDK للتحويل هذا بتمكينك من تحويل ملفات HTML إلى تنسيق PDF بسهولة، مما يسهل سير العمل بشكل أكثر سلاسة وتحسين الإنتاجية.

الآن، من أجل استخدام SDK، الخطوة الأولى هي تثبيته. ما عليك سوى البحث في GroupDocs.Conversion-Cloud في مدير الحزم NuGet والنقر فوق الزر “تثبيت”. هناك خيار آخر وهو تنفيذ الأمر التالي في وحدة تحكم مدير الحزم.

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

بمجرد تثبيت REST API بنجاح، تأكد من أن لديك بيانات اعتماد API (أي معرف العميل وسر العميل).يمكنك زيارة هذا [البرنامج التعليمي] القصير 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” واسم مستند 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";

// قم بإنشاء مثيل لفئة التكوين وقم بتهيئته باستخدام معرف العميل وسر العميل. 
var configurations = new GroupDocs.Conversion.Cloud.Sdk.Client.Configuration(clientId, clientSecret1);
// حدد قيمة ApiBaseUrl لتعيين عنوان url الأساسي لواجهة برمجة تطبيقات محول html إلى PDF.
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

// تهيئة مثيل لفئة ConvertApi مع كائن فئة التكوين.
var apiInstance = new GroupDocs.Conversion.Cloud.Sdk.Api.ConvertApi(configurations);
             
// قم بتحميل ملف HTML من محرك الأقراص المحلي             
using (var stream = System.IO.File.OpenRead("converted.html"))
{
    // إنشاء instnace من 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، يمكن للمستخدمين أتمتة عملية التحويل، مما يوفر الوقت والجهد في المهام المتكررة.

تأكد من حصولك على بيانات اعتماد واجهة برمجة التطبيقات (App Key وApp 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 to PDF Converter] عبر الإنترنت 14. إنه مجاني وخفيف الوزن وفائق الكفاءة ويوفر تحويلاً قويًا من HTML إلى PDF.

تطبيق مجاني لتحويل html إلى pdf

روابط مفيدة

خاتمة

لقد تعلمنا أن GroupDocs.Conversion Cloud توفر حلاً سلسًا وفعالًا وموثوقًا لمهام تحويل المستندات، مما يمكّنك من تبسيط سير العمل وتحسين الإنتاجية. لذلك، من خلال أتمتة عملية التحويل وضمان الاتساق والدقة في النتائج، تعمل GroupDocs.Conversion Cloud API على تبسيط المهام المعقدة وتوفير الوقت والموارد القيمة. لذلك، سواء كنت مطورًا يتطلع إلى دمج إمكانات تحويل المستندات في تطبيقاتك أو شركة تسعى إلى تحسين عمليات إدارة المستندات لديك، فإن واجهات برمجة التطبيقات الخاصة بنا توفر الأدوات التي تحتاجها لتحقيق النجاح.

مقالات ذات صلة

نوصي بشدة بزيارة الروابط التالية لمعرفة المزيد حول: