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

فایل HTML به طور گسترده در اینترنت برای به اشتراک گذاری اطلاعات استفاده می شود. از آنجایی که توسط اکثر پلتفرم ها پشتیبانی می شود و تقریباً همه مرورگرهای وب قادر به بارگذاری این فرمت هستند، بنابراین آن را به یکی از فرمت های قابل قبول تبدیل می کند. با این حال، به دلیل استقبال گسترده آن، بسیاری از هکرها سعی می کنند اسکریپت های مخرب را در فایل های HTML جاسازی کنند. حملات پرکاربرد کدهای مخرب HTML و Java اسکریپت در سال‌های اخیر افزایش چشمگیری در آگاهی و بهره‌برداری داشته است. از طرف دیگر، یک فایل XPS فایل‌های طرح‌بندی صفحه را نشان می‌دهد که بر اساس مشخصات کاغذ XML هستند.

XPS شبیه فرمت فایل PDF است اما از XML در چیدمان، ظاهر و اطلاعات چاپ یک سند استفاده می کند.

HTML Conversion API
HTML به XPS در سی شارپ
HTML را با استفاده از cURL به XPS تبدیل کنید

API تبدیل HTML

Aspose.HTML Cloud به طور خاص برای ارائه قابلیت های پردازش فایل های HTML طراحی شده است. علاوه بر HTML ورودی، می‌توانیم XHTML، MHTML، EPUB، Markdown یا یک صفحه وب را با URL آن بارگیری کنیم. خروجی حاصل می تواند فرمت های PDF، XPS، DOCX یا تصویر شطرنجی باشد: JPEG، PNG، TIFF، BMP، GIF. از آنجایی که API بر اساس معماری REST توسعه یافته است، بنابراین می توان از آن در برنامه های دسکتاپ، موبایل، وب و ترکیبی و همچنین پلتفرم های دسکتاپ یا موبایل استفاده کرد.

به منظور تسهیل بیشتر مشتریان خود، ما SDK های مخصوص زبان برنامه نویسی را ایجاد کرده ایم. Cloud SDK ها در اطراف API های 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 در ویژوال استودیو است. لطفا دستور زیر را اجرا کنید:

 PM> Install-Package Aspose.HTML-Cloud

کنسول Package Manager — تصویر 1: - بسته Aspose.HTML NuGet نصب شده است.

NuGet Package Manager

ساده ترین روش دیگر نصب SDK از طریق NuGet Package Manager در Visual Studio IDE است.

Solution Explorer را باز کنید.
پروژه را گسترش دهید و روی پوشه Packages در محلول خود کلیک راست کنید.
گزینه Manage NuGet Packages… را انتخاب کنید.
روی تب Browse کلیک کنید و “Aspose.HTML-Cloud” را جستجو کنید.
روی بسته Aspose.HTML-Cloud کلیک کنید، نسخه مناسب را در برگه سمت راست انتخاب کنید و روی دکمه Add Package کلیک کنید.

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

اشتراک رایگان ابر

مرحله مهم بعدی اشتراک رایگان حساب در Aspose.Cloud dashboard است. هیچ کارت اعتباری یا سایر جزئیات پرداخت مورد نیاز نیست. اگر یک حساب GitHub یا Google دارید، به سادگی ثبت نام کنید یا روی دکمه ایجاد یک حساب جدید کلیک کنید و اطلاعات مورد نیاز را ارائه دهید. اکنون با استفاده از اعتبارنامه وارد داشبورد شوید و بخش Applications را از داشبورد گسترش دهید و به سمت پایین به سمت قسمت Client Credentials حرکت کنید تا Client ID و Client Secret را ببینید.

تصویر 3: - اعتبار مشتری در داشبورد Aspose.Cloud.

HTML به XPS در C#

در این قسمت قصد داریم در مورد تبدیل فایل های HTML به فرمت XPS برای دو حالت زیر بحث کنیم.

HTML را از فضای ذخیره سازی ابری بارگیری کنید

لطفاً دستورالعمل‌های زیر را برای آپلود یک فایل HTML در فضای ذخیره‌سازی ابری دنبال کنید و سپس تبدیل به فرمت XPS را انجام دهید.

اول از همه، لطفاً در حین انتقال اطلاعات ClientID و ClientSecret به عنوان آرگومان، نمونه HtmlApi ایجاد کنید.
در مرحله دوم، فایل HTML را با استفاده از روش File.OpenRead(…) بخوانید.
سوم، یک نمونه از StorageApi ایجاد کنید و از روش UploadFile(…) برای آپلود فایل HTML در فضای ذخیره سازی ابری استفاده کنید.
در نهایت، روش PutConvertDocumentToXps(…) را فراخوانی کنید تا تبدیل HTML به XPS را انجام دهید و XPS حاصل را در فضای ذخیره‌سازی ابری ذخیره کنید.

// ClientID را از 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 را با استفاده از cURL به XPS تبدیل کنید

از آنجایی که API های ما بر اساس معماری REST توسعه یافته اند، بنابراین می توان از طریق دستورات cURL نیز به آنها دسترسی داشت. در این قسمت قصد داریم با استفاده از دستور cURL در مورد تبدیل صفحه HTML به فرمت XPS صحبت کنیم. اما قبل از اینکه ادامه دهیم، اولین قدم ایجاد JSON Web Token (JWT) بر اساس اعتبار مشتری از داشبورد Aspose.Cloud است. لطفاً مراحل زیر را برای انجام تبدیل HTML به XPS دنبال کنید.

Client ID و Client Secret خود را از داشبورد Cloud دریافت کنید.
رمز دسترسی به وب JSON را بر اساس اعتبار مشتری دریافت کنید.
API PutConvertDocumentToXps را فراخوانی کنید.
فایل 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 استفاده کنید. این برنامه در بالای API های REST توسعه یافته است و شما را قادر می سازد تا قابلیت های شگفت انگیز API را تجربه کنید.

نتیجه گیری

ما قابلیت‌های Aspose.HTML Cloud را برای تبدیل فایل‌های HTML به طرح‌بندی صفحه ثابت و سایر تصاویر شطرنجی بررسی کرده‌ایم. ما ویژگی های تبدیل HTML با استفاده از قطعه کد C#.NET و همچنین با استفاده از دستورات cURL را بررسی کرده ایم.

با این وجود، Aspose.HTML Cloud SDK for .NET که پوششی پیرامون Aspose.HTML Cloud است تحت مجوز MIT توسعه یافته است، بنابراین قطعه کد کامل را می توان از GitHub دانلود کرد. اگر هنگام استفاده از API با مشکلی مواجه شدید، لطفاً از طریق تالار گفتمان پشتیبانی رایگان محصول با ما تماس بگیرید.

مقالات مرتبط

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

API تبدیل HTML#

نصب و راه اندازی#

NuGet Package Manager#

اشتراک رایگان ابر#

HTML به XPS در C##

HTML را از فضای ذخیره سازی ابری بارگیری کنید#

HTML را با استفاده از cURL به XPS تبدیل کنید#

نمایشگر XPS رایگان#

نتیجه گیری#

مقالات مرتبط#