Перетворення HTML на XPS у C# .NET

html в xps — Як конвертувати HTML у XPS у C# .NET

Файл HTML широко використовується в Інтернеті для обміну інформацією. Оскільки він підтримується більшістю платформ і майже всі веб-браузери можуть завантажувати цей формат, це робить його одним із прийнятних форматів. Однак через його широке визнання багато хакерів намагаються вставити шкідливі сценарії у файли HTML. За останні роки гучні атаки зловмисного коду HTML і JavaScript різко зросли як в обізнаності, так і в експлуатації. З іншого боку, файл XPS представляє файли макетів сторінок, які базуються на специфікаціях паперу XML.

XPS схожий на формат файлу PDF, але використовує XML у макеті, зовнішньому вигляді та інформації для друку документа.

API перетворення HTML
HTML до XPS на C#
Перетворення HTML на XPS за допомогою cURL

API перетворення HTML

Aspose.HTML Cloud спеціально розроблено для забезпечення можливостей обробки файлів HTML. Окрім вхідного HTML, ми також можемо завантажити XHTML, MHTML, EPUB, Markdown або веб-сторінку за її URL-адресою. Результатом може бути PDF, XPS, DOCX або растровий формат зображення: JPEG, PNG, TIFF, BMP, GIF. Оскільки API розроблено відповідно до архітектури REST, його можна використовувати в настільних, мобільних, веб- та гібридних програмах, а також на настільних і мобільних платформах.

Щоб ще більше полегшити роботу наших клієнтів, ми створили SDK для окремих мов програмування. Хмарні пакети SDK є оболонками REST API на різних мовах програмування, що дозволяє обробляти документи вибраною вами мовою. Таким чином, ви можете швидко та легко отримати всі переваги сильних типів і виділення IDE. Будь ласка, перевірте репозиторій Aspose.HTML GitHub на наявність пакетів SDK разом із робочими прикладами, щоб швидко розпочати роботу. У цій статті ми обговоримо функції перетворення документів Aspose.HTML Cloud SDK для .NET.

монтаж

Щоб почати використовувати Cloud SDK, спочатку потрібно встановити його в системі. SDK доступний через NuGet і GitHub. Виконайте наведену нижче команду у вікні терміналу, щоб інсталювати NuGet

nuget install Aspose.HTML-Cloud

Іншим варіантом є інсталяція SDK через консоль диспетчера пакетів у Visual Studio. Будь ласка, виконайте таку команду:

 PM> Install-Package Aspose.HTML-Cloud

Консоль менеджера пакетів — Зображення 1: - Встановлено пакет Aspose.HTML NuGet.

Менеджер пакетів NuGet

Ще один найпростіший підхід — установити SDK через диспетчер пакетів NuGet у Visual Studio IDE.

Відкрийте провідник рішень.
Розгорніть проект і клацніть правою кнопкою миші папку Packages у своєму рішенні.
Виберіть параметр «Керувати пакетами NuGet…».
Натисніть вкладку «Огляд» і знайдіть «Aspose.HTML-Cloud».
Клацніть пакет Aspose.HTML-Cloud, виберіть відповідну версію на правій вкладці та натисніть кнопку «Додати пакет».

Зображення 2: Пакет Aspose.HTML у диспетчері пакетів NuGet.

Безкоштовна хмарна підписка

Наступним важливим кроком є безкоштовна підписка на обліковий запис на інформаційній панелі Aspose.Cloud. Кредитна картка чи інші платіжні реквізити не потрібні. Якщо у вас є обліковий запис GitHub або Google, просто зареєструйтеся або натисніть кнопку створити новий обліковий запис і надайте необхідну інформацію. Тепер увійдіть на інформаційну панель, використовуючи облікові дані, розгорніть розділ «Програми» на інформаційній панелі та прокрутіть униз до розділу «Облікові дані клієнта», щоб переглянути дані про ідентифікатор клієнта та секрет клієнта.

Облікові дані клієнта — Зображення 3: облікові дані клієнта на інформаційній панелі Aspose.Cloud.

HTML до XPS на C#

У цьому розділі ми обговоримо перетворення файлів HTML у формат XPS для наступних двох сценаріїв.

Завантажте HTML із Cloud Storage

Дотримуйтеся наведених нижче інструкцій, щоб завантажити файл HTML у хмарне сховище, а потім виконати перетворення у формат XPS.

Перш за все, будь ласка, створіть екземпляр HtmlApi, передаючи дані ClientID і ClientSecret як аргументи.
По-друге, прочитайте файл 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);
}

Зображення 4: попередній перегляд перетворення HTML у XPS.

З метою тестування вхідний HTML і результуючий XPS можна завантажити з inputHTML.html і Resultant.xps.

Перетворення HTML на XPS за допомогою cURL

Оскільки наші API розроблено відповідно до архітектури REST, до них також можна отримати доступ за допомогою команд cURL. У цьому розділі ми обговоримо перетворення сторінки HTML у формат XPS за допомогою команди cURL. Але перш ніж продовжити, першим кроком буде створення JSON Web Token (JWT) на основі облікових даних клієнта з інформаційної панелі Aspose.Cloud. Щоб виконати перетворення HTML у XPS, виконайте наведені нижче дії.

Отримайте свій ідентифікатор клієнта та секрет клієнта з інформаційної панелі 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 Viewer App. Він розроблений на основі REST API і дає вам змогу відчути дивовижні можливості API.

Висновок

Ми дослідили можливості Aspose.HTML Cloud для перетворення файлів HTML у фіксований макет сторінки та інші растрові зображення. Ми дослідили функції для перетворення HTML за допомогою фрагмента коду C# .NET, а також за допомогою команд cURL.

Тим не менш, Aspose.HTML Cloud SDK for .NET, який є оболонкою для Aspose.HTML Cloud, розроблено за ліцензією MIT, тому повний фрагмент коду можна завантажити з GitHub. Якщо у вас виникнуть проблеми під час використання API, будь ласка, зв’яжіться з нами через безкоштовний форум підтримки продуктів.

Схожі статті

Рекомендуємо перейти за наведеними нижче посиланнями, щоб дізнатися більше

API перетворення HTML#

монтаж#

Менеджер пакетів NuGet#

Безкоштовна хмарна підписка#

HTML до XPS на C##

Завантажте HTML із Cloud Storage#

Перетворення HTML на XPS за допомогою cURL#

Безкоштовний засіб перегляду XPS#

Висновок#

Схожі статті#