Преобразование HTML в PDF в C# .NET

Спрос на эффективные решения для управления документами продолжает расти в геометрической прогрессии. В этой статье мы подробно рассмотрим преимущества и практическое применение использования .NET Cloud API для преобразования HTML в PDF. От оптимизации рабочих процессов до обеспечения совместимости между различными платформами — узнайте, как эта функция может значительно повысить производительность и упростить задачи управления документами.

В этой статье рассматриваются следующие темы:

API преобразования HTML в PDF

Мы собираемся изучить надежные возможности GroupDocs.Conversion Cloud SDK для .NET и его ключевую роль в беспрепятственном выполнении требований преобразования HTML в PDF. Поскольку предприятия и разработчики ищут эффективные решения для управления документами, этот API становится мощным инструментом, предлагающим беспрецедентную простоту и универсальность. Давайте углубимся в то, как этот пакет SDK для преобразования позволяет легко конвертировать HTML-файлы в формат PDF, что упрощает рабочие процессы и повышает производительность.

Теперь, чтобы использовать SDK, первым шагом является его установка. Просто найдите GroupDocs.Conversion-Cloud в диспетчере пакетов NuGet и нажмите кнопку «Установить». Другой вариант — выполнить следующую команду в консоли диспетчера пакетов.

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

После успешной установки REST API убедитесь, что у вас есть учетные данные API (т. е. идентификатор клиента и секрет клиента).Вы можете посетить это короткое руководство, чтобы узнать, как получить учетные данные 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. Вызовите API ConvertDocumentRequest для преобразования 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";

// Создайте экземпляр класса Configuration и инициализируйте его с помощью идентификатора клиента и секрета клиента. 
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, устраняющий необходимость в сложных ручных процессах. Таким образом, используя Cloud API GroupDocs.Conversion, пользователи могут автоматизировать процесс преобразования, экономя время и усилия при выполнении повторяющихся задач.

Убедитесь, что вы получили свои учетные данные API (ключ приложения и идентификатор безопасности приложения) на панели мониторинга 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

На основе API GroupDocs.Conversion Cloud мы разработали онлайн-конвертер HTML в PDF]14. Это бесплатный, легкий, сверхэффективный инструмент, обеспечивающий надежное преобразование HTML в PDF.

бесплатное приложение HTML в PDF

Полезные ссылки

Заключение

Мы узнали, что GroupDocs.Conversion Cloud предлагает комплексное, эффективное и надежное решение задач преобразования документов, позволяющее оптимизировать рабочие процессы и повысить производительность. Таким образом, автоматизируя процесс преобразования и обеспечивая согласованность и точность результатов, GroupDocs.Conversion Cloud API упрощает сложные задачи и экономит драгоценное время и ресурсы. Поэтому независимо от того, являетесь ли вы разработчиком, желающим интегрировать возможности преобразования документов в свои приложения, или бизнесом, стремящимся оптимизировать процессы управления документами, наши API предоставляют инструменты, необходимые для достижения успеха.

Статьи по Теме

Мы настоятельно рекомендуем посетить следующие ссылки, чтобы узнать больше о: