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

ملف HTML يستخدم على نطاق واسع عبر الإنترنت لمشاركة المعلومات. ونظرًا لأنه مدعوم من قبل غالبية المنصات وكون جميع متصفحات الويب تقريبًا قادرة على تحميل هذا التنسيق، فهو يجعله أحد التنسيقات المقبولة. ومع ذلك، نظرًا لقبوله الواسع، يحاول العديد من المتسللين تضمين البرامج النصية الضارة داخل ملفات HTML. وقد شهدت الهجمات البارزة باستخدام أكواد HTML وJavaScript الضارة زيادة كبيرة في كل من الوعي والاستغلال في السنوات الأخيرة. من ناحية أخرى، يمثل ملف XPS ملفات تخطيط الصفحة المستندة إلى مواصفات XML Paper.

تنسيق XPS مشابه لتنسيق ملف PDF ولكنه يستخدم XML في تخطيط المستند ومظهره ومعلومات الطباعة الخاصة به.

واجهة برمجة تطبيقات تحويل HTML
تحويل HTML إلى XPS في C#
تحويل HTML إلى XPS باستخدام cURL

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

تم تصميم Aspose.HTML Cloud خصيصًا لتوفير الإمكانيات اللازمة لمعالجة ملفات HTML. وبصرف النظر عن إدخال HTML، يمكننا أيضًا تحميل XHTML، MHTML، EPUB، Markdown، أو صفحة ويب من خلال عنوان URL الخاص بها. يمكن أن يكون الناتج الناتج بتنسيق PDF أو XPS أو DOCX أو تنسيقات الصور النقطية: JPEG أو PNG أو TIFF أو BMP أو GIF. نظرًا لأن واجهة برمجة التطبيقات تم تطويرها وفقًا لهندسة REST، فيمكن استخدامها في تطبيقات سطح المكتب والجوال والويب والتطبيقات الهجينة، بالإضافة إلى منصات سطح المكتب أو الجوال.

من أجل تسهيل الأمور على عملائنا، قمنا بإنشاء حزم SDK خاصة بلغات البرمجة. حزم SDK السحابية عبارة عن غلافات حول واجهات برمجة التطبيقات REST بلغات برمجة مختلفة، مما يسمح لك بمعالجة المستندات باللغة التي تختارها. بهذه الطريقة، يمكنك بسرعة وسهولة الحصول على جميع فوائد الأنواع القوية وإبرازات IDE. يرجى مراجعة مستودع Aspose.HTML GitHub للحصول على حزم SDK جنبًا إلى جنب مع الأمثلة العملية، لتبدأ في أي وقت من الأوقات. في هذه المقالة، سنناقش ميزات تحويل المستندات في Aspose.HTML Cloud SDK for .NET.

تثبيت

للبدء في استخدام Cloud SDK، فإن الخطوة الأولى هي تثبيته عبر النظام. تتوفر SDK عبر NuGet وGitHub. يرجى تنفيذ الأمر التالي في نافذة المحطة الطرفية لإجراء التثبيت لـ NuGet

nuget install Aspose.HTML-Cloud

هناك خيار آخر يتمثل في تثبيت SDK من خلال Package Manager Console ضمن Visual Studio. يرجى تنفيذ الأمر التالي:

 PM> Install-Package Aspose.HTML-Cloud

وحدة تحكم إدارة الحزم — الصورة 1: - تم تثبيت حزمة Aspose.HTML NuGet.

مدير الحزم NuGet

الطريقة الأسهل الأخرى هي تثبيت SDK عبر NuGet Package Manager داخل Visual Studio IDE.

افتح مستكشف الحلول.
قم بتوسيع المشروع ثم انقر بزر الماوس الأيمن فوق مجلد الحزم ضمن الحل الخاص بك.
حدد خيار إدارة حزم NuGet…
انقر فوق علامة التبويب “استعراض” وابحث عن “Aspose.HTML-Cloud”.
انقر فوق الحزمة Aspose.HTML-Cloud، وحدد الإصدار المناسب في علامة التبويب اليمنى وانقر فوق الزر “إضافة حزمة”.

html to xps — Image 2:- Aspose.HTML Package in NuGet Package Manager.

اشتراك سحابي مجاني

الخطوة المهمة التالية هي الاشتراك في حساب مجاني على لوحة تحكم Aspose.Cloud. لا يلزم وجود بطاقة ائتمان أو تفاصيل دفع أخرى. إذا كان لديك حساب GitHub أو Google، فما عليك سوى التسجيل أو النقر فوق الزر إنشاء حساب جديد وتقديم المعلومات المطلوبة. الآن قم بتسجيل الدخول إلى لوحة التحكم باستخدام بيانات الاعتماد وقم بتوسيع قسم التطبيقات من لوحة التحكم وانتقل لأسفل نحو قسم بيانات اعتماد العميل لرؤية تفاصيل معرف العميل والسر الخاص بالعميل.

الصورة 3:- بيانات اعتماد العميل في لوحة معلومات Aspose.Cloud.

تحويل HTML إلى XPS في C#

في هذا القسم، سنناقش تحويل ملفات HTML إلى تنسيق XPS في السيناريوهين التاليين.

تحميل HTML من التخزين السحابي

يرجى اتباع الإرشادات أدناه لتحميل ملف HTML إلى التخزين السحابي ثم إجراء التحويل إلى تنسيق XPS.

أولاً، يرجى إنشاء مثيل HtmlApi أثناء تمرير تفاصيل ClientID وClientSecret كوسائط.
ثانياً، اقرأ ملف HTML باستخدام طريقة File.OpenRead(…)
ثالثًا، قم بإنشاء مثيل لـ StorageApi واستخدم طريقة UploadFile(…) لتحميل ملف HTML إلى التخزين السحابي.
أخيرًا، اتصل بطريقة PutConvertDocumentToXps(…) لإجراء تحويل HTML إلى XPS وحفظ XPS الناتج في التخزين السحابي.

// احصل على معرف العميل من https://dashboard.aspose.cloud/
string clientSecret = "d757548a9f2558c39c2feebdf85b4c44";
string clientID = "4db2f826-bf9c-42e7-8b2a-8cbca2d15553";
// سلسلة عنوان URL الأساسية
const string SERVICE_API_HOST = "https://api.aspose.cloud";

// إنشاء مثيل HtmlApi
HtmlApi htmlApi = new HtmlApi(clientID, clientSecret,SERVICE_API_HOST);

String name = "inputHTML.html";// inpit Document name.
int width = 800; // Resulting image width.
int height = 1000; // Resulting image height.
int leftMargin = 10; // Left resulting image margin.
int rightMargin = 10; // Right resulting image margin.
int topMargin = 10; // Top resulting image margin.
int bottomMargin = 10; // Bottom resulting image margin.

// اسم الملف الناتج
string resultantFile = "Resultant.xps";

try
{
    // تحميل الملف من محرك الأقراص المحلي
    using (var file = System.IO.File.OpenRead(@"C:\Users\shahbnay\Desktop\" + name))
    {
        // إنشاء مثيل StorageApi
        var uploadFileRequest = new StorageApi(clientID, clientSecret, SERVICE_API_HOST);
        
        // تحميل ملف HTML إلى التخزين السحابي
        uploadFileRequest.UploadFile(file, "inputHTML.html");
    }
    
    // قم بإجراء التحويل إلى صيغة PDF
    // حفظ الناتج في التخزين السحابي
    AsposeResponse response = htmlApi.PutConvertDocumentToPdf(
    name, resultantFile, width, height,
    leftMargin, rightMargin, topMargin, bottomMargin);
    
    // طباعة رسالة النجاح إذا كان التحويل ناجحًا
    if (response != null && response.Equals("OK"))
    {
        Console.WriteLine("HTML successfully converted to XPS !");
    }
}catch (Exception ex)
{
    Console.WriteLine("error:" + ex.Message + "\n" + ex.StackTrace);
}

التسمية التوضيحية — Image 4:- HTML to XPS conversion preview.

لأغراض الاختبار، يمكن تنزيل ملف HTML المدخل وملف XPS الناتج من inputHTML.html وResultant.xps.

تحويل HTML إلى XPS باستخدام cURL

نظرًا لأن واجهات برمجة التطبيقات الخاصة بنا تم تطويرها وفقًا لهندسة REST، فيمكن أيضًا الوصول إليها عبر أوامر cURL. في هذا القسم، سنناقش تحويل صفحة HTML إلى تنسيق XPS باستخدام أمر cURL. ولكن قبل أن نواصل، فإن الخطوة الأولى هي إنشاء رمز ويب JSON (JWT) استنادًا إلى بيانات اعتماد العميل من لوحة تحكم Aspose.Cloud. يرجى اتباع الخطوات الموضحة أدناه لإجراء تحويل HTML إلى XPS.

احصل على معرف العميل والسر الخاص بالعميل من لوحة معلومات السحابة.
احصل على رمز وصول الويب JSON استنادًا إلى بيانات اعتماد العميل.
اتصل بـ PutConvertDocumentToXps API.
سيتم حفظ ملف PDF الناتج في التخزين السحابي.

يرجى تنفيذ أمر cURL التالي لتوليد رمز وصول JWT.

 curl -v "https://api.aspose.cloud/connect/token" \
 -X POST \
 -d "grant_type=client_credentials&client_id=4db2f826-bf9c-42e7-8b2a-8cbca2d15553&client_secret=d757548a9f2558c39c2feebdf85b4c44" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Accept: application/json"

يرجى تنفيذ الأمر التالي لتحميل ملفات HTML إلى التخزين السحابي:

curl -X PUT "https://api.aspose.cloud/html/storage/file/inputHTML.html" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-H  "Content-Type: multipart/form-data" \
-d {"File":{}}

بعد تحميل HTML إلى التخزين السحابي، يمكن استخدام الأمر التالي لإجراء تحويل HTML إلى XPS وحفظ الملف الناتج في التخزين السحابي.

curl -X PUT "https://api.aspose.cloud/html/inputHTML.html/convert/xps?outPath=converted.xps&width=800&height=1000&leftMargin=10&rightMargin=10&topMargin=10&bottomMargin=10" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>"

عارض XPS مجاني

لعرض ملف XPS، يمكنك التفكير في استخدام تطبيق XPS Viewer. تم تطويره على واجهات برمجة تطبيقات REST ويتيح لك تجربة الإمكانات المذهلة لواجهة برمجة التطبيقات.

خاتمة

لقد استكشفنا إمكانيات Aspose.HTML Cloud لتحويل ملفات HTML إلى تخطيط صفحة ثابت وصور نقطية أخرى. لقد استكشفنا الميزات لتحويل HTML باستخدام مقتطفات التعليمات البرمجية بلغة C# .NET بالإضافة إلى استخدام أوامر cURL.

ومع ذلك، فإن Aspose.HTML Cloud SDK for .NET وهو غلاف حول Aspose.HTML Cloud تم تطويره بموجب ترخيص MIT، لذا يمكن تنزيل مقتطف التعليمات البرمجية الكامل من GitHub. إذا واجهت أي مشكلات أثناء استخدام واجهة برمجة التطبيقات، فلا تتردد في الاتصال بنا عبر منتدى دعم المنتج المجاني.

واجهة برمجة تطبيقات تحويل HTML#

تثبيت#

مدير الحزم NuGet#

اشتراك سحابي مجاني#

تحويل HTML إلى XPS في C##

تحميل HTML من التخزين السحابي#

تحويل HTML إلى XPS باستخدام cURL#

عارض XPS مجاني#

خاتمة#

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