Конвертировать HTML в PDF – примеры C# и онлайн-конвертер

В этом руководстве вы найдете информацию о том, как преобразовать документ HTML в формат файла Portable Document Format (PDF) с помощью библиотеки Aspose.HTML для .NET. Мы подробно рассмотрим, как конвертировать HTML в PDF с помощью методов ConvertHTML() класса Converter, и как применить PdfSaveOptions и ICreateStreamProvider.

Чтобы продолжить следовать этому руководству, вы должны установить и настроить библиотеку Aspose.HTML для .NET в своем проекте C#. Наши примеры кода помогут вам преобразовать HTML в PDF и создать PDF-файлы с помощью библиотеки C#.

HTML в PDF одной строкой кода

Преобразование HTML в PDF очень популярно. Для выполнения этой функции Aspose.HTML для .NET предлагает статические методы класса Converter как понятный и простой способ преобразовать код HTML в файл PDF буквально с помощью одной строки кода!

1using System.IO;
2using Aspose.Html.Converters;
3using Aspose.Html.Saving;
4...
5    // Invoke ConvertHTML() method to convert the HTML code to PDF file
6    Converter.ConvertHTML(@"<h1>Convert HTML to PDF!</h1>", ".", new PdfSaveOptions(), Path.Combine(OutputDir, "convert-with-single-line.pdf"));

Онлайн HTML Конвертер

Вы можете проверить функциональность Aspose.HTML API и конвертировать HTML в режиме реального времени. Пожалуйста, загрузите HTML из локальной файловой системы, выберите выходной формат и запустите пример. В примере параметры сохранения установлены по умолчанию. Вы сразу получите результат в виде отдельного файла.

                
            

Если вы хотите программно преобразовать HTML в PDF, давайте рассмотрим следующие примеры кода C#.

Конвертировать HTML в PDF на C#

Любое преобразование HTML в PDF, которое вы хотите выполнить, включает загрузку документа HTML и сохранение его в формате PDF. Вы можете загрузить HTML из файла, HTML-кода, потока или URL-адреса (см. статью Создание HTML-документа). Это могут быть разные сценарии, но это можно сделать с помощью нескольких обязательных шагов:

  1. Загрузите файл HTML с помощью одного из конструкторов HTMLDocument() класса HTMLDocument. В примере мы используем конструктор HTMLDocument(string), который инициализирует HTML-документ из файла.
  2. Создайте новый объект PdfSaveOptions.
  3. Используйте метод ConvertHTML() класса Converter для сохранения HTML в виде файла PDF. Вам нужно передать HTMLDocument, PdfSaveOptions и путь к выходному файлу методу ConvertHTML() для преобразования HTML в PDF.

Чтобы продолжить работу с этим руководством, нам понадобится файл HTML для работы. Вот пример HTML-файла, который мы будем использовать в следующем примере C# – spring.html. Если вы откроете его в своем браузере, вы должны увидеть:

Текст “На рисунке показан файл spring.html”

Просмотрите следующий фрагмент кода C#, в котором показан процесс преобразования HTML в PDF для файла spring.html.

 1using System.IO;
 2using Aspose.Html;
 3using Aspose.Html.Converters;
 4using Aspose.Html.Saving;
 5...
 6    // Prepare a path to a source HTML file
 7    string documentPath = Path.Combine(DataDir, "spring.html");
 8
 9    // Prepare a path for converted file saving 
10    string savePath = Path.Combine(OutputDir, "spring-output.pdf");
11
12    // Initialize an HTML document from the file
13    using var document = new HTMLDocument(documentPath);
14
15    // Initialize PdfSaveOptions 
16    var options = new PdfSaveOptions();
17
18    // Convert HTML to PDF
19    Converter.ConvertHTML(document, options, savePath);

Параметры Сохранения

Функциональность создания PDF может быть расширена за счет параметров сохранения в соответствии с вашими потребностями. Aspose.HTML позволяет конвертировать HTML в PDF, используя стандартные или пользовательские параметры сохранения. Использование PdfSaveOptions позволяет настроить процесс рендеринга; вы можете указать размер страницы, поля, права доступа к файлам, Css и т. д.

PropertyDescription
JpegQualitySpecifies the quality of JPEG compression for images. The default value is 95.
CssGets a CssOptions object which is used for configuration of CSS properties processing.
DocumentInfoThis property contains information about the output PDF document.
BackgroundColorThis property sets the color that will fill the background of every page. By default, this property is Transparent.
PageSetupThis property gets a page setup object and uses it for configuration output page-set.
HorizontalResolutionSets horizontal resolution for output images in pixels per inch. The default value is 300 dpi.
VerticalResolutionSets vertical resolution for output images in pixels per inch. The default value is 300 dpi.
EncryptionThis property gets or sets encryption details. If it is not set, then no encryption will be performed.

Чтобы узнать больше о PdfSaveOptions, прочитайте статьи раздела Конвертеры тонкой настройки. Вы можете скачать полные примеры и файлы данных с GitHub.

Конвертировать HTML в PDF на C# с использованием PdfSaveOptions

С помощью Aspose.HTML вы можете программно конвертировать файлы с полным контролем над широким диапазоном параметров конвертации. Чтобы преобразовать HTML в PDF с указанием PdfSaveOptions, вы должны выполнить несколько шагов:

  1. Загрузите файл HTML с помощью одного из конструкторов HTMLDocument() класса HTMLDocument.
  2. Создайте новый объект PdfSaveOptions и укажите необходимые свойства. Класс PdfSaveOptions предоставляет множество свойств, которые дают вам полный контроль над широким спектром параметров и улучшают процесс преобразования HTML в формат PDF.
  3. Используйте метод ConvertHTML() класса Converter для сохранения HTML в виде файла PDF. Метод ConvertHTML() принимает document, options, путь к выходному файлу savePath и выполняет операцию преобразования.

В следующем примере показано, как использовать PdfSaveOptions и создать файл PDF с пользовательскими параметрами сохранения:

 1using System.IO;
 2using Aspose.Html;
 3using Aspose.Html.Converters;
 4using Aspose.Html.Saving;
 5using System.Drawing;
 6using Aspose.Html.Drawing;
 7...
 8    // Prepare a path to a source HTML file
 9    string documentPath = Path.Combine(DataDir, "spring.html");
10
11    // Prepare a path for converted file saving 
12    string savePath = Path.Combine(OutputDir, "spring-options.pdf");
13
14    // Initialize an HTML document from the file
15    using var document = new HTMLDocument(documentPath);
16
17    // Initialize PdfSaveOptions. Set up the page-size 600x300 pixels, margins, resolutions and change the background color to AliceBlue 
18    var options = new PdfSaveOptions()
19    {
20        HorizontalResolution = 200,
21        VerticalResolution = 200,
22        JpegQuality = 100,
23        BackgroundColor = System.Drawing.Color.AliceBlue
24    };
25    options.PageSetup.AnyPage = new Page(new Aspose.Html.Drawing.Size(600, 300), new Margin(20, 10, 10, 10));
26
27    // Convert HTML to PDF
28    Converter.ConvertHTML(document, options, savePath);

В приведенном выше примере мы используем:

Преобразование HTML в PDF можно гибко настроить для получения желаемого результата. В следующих статьях вы найдете ответы на популярные вопросы о преобразовании HTML в PDF:

Output Stream Providers

Если требуется сохранять файлы в удаленном хранилище (например, в облаке, базе данных и т. д.), вы можете реализовать ICreateStreamProvider для ручного управления процессом создания файла. Этот интерфейс разработан как объект обратного вызова для создания потока в начале документа/страницы (в зависимости от выходного формата) и освобождения ранее созданного потока после рендеринга документа/страницы. Библиотека C# Aspose.HTML позволяет реализовать класс MemoryStreamProvider как пользовательскую реализацию интерфейса ICreateStreamProvider. Класс MemoryStreamProvider предоставляет объекты C# MemoryStream в качестве выходных потоков для записи данных, которые могут храниться в памяти в виде потока:

 1using System.IO;
 2using System.Collections.Generic;
 3...
 4    class MemoryStreamProvider : Aspose.Html.IO.ICreateStreamProvider
 5    {
 6        // List of MemoryStream objects created during the document rendering
 7        public List<MemoryStream> Streams { get; } = new List<MemoryStream>();
 8
 9        public Stream GetStream(string name, string extension)
10        {
11            // This method is called when only one output stream is required, for instance for XPS, PDF or TIFF formats.
12            MemoryStream result = new MemoryStream();
13            Streams.Add(result);
14            return result;
15        }
16
17        public Stream GetStream(string name, string extension, int page)
18        {
19            // This method is called when the creation of multiple output streams are required. For instance, during the rendering HTML to list of image files (JPG, PNG, etc.)
20            MemoryStream result = new MemoryStream();
21            Streams.Add(result);
22            return result;
23        }
24
25        public void ReleaseStream(Stream stream)
26        {
27            //  Here you can release the stream filled with data and, for instance, flush it to the hard-drive
28        }
29
30        public void Dispose()
31        {
32            // Releasing resources
33            foreach (var stream in Streams)
34                stream.Dispose();
35        }
36    }

Aspose.HTML для .NET предоставляет различные типы выходных форматов для операций рендеринга. Некоторые из этих форматов создают один выходной файл (например, PDF и XPS), другие создают несколько файлов (форматы изображений JPG, PNG, и т. д.).

Следующий код C# демонстрирует, как использовать класс MemoryStreamProvider и библиотеку Aspose.HTML для .NET для преобразования HTML в PDF и сохранения результата в файл.

 1using System.IO;
 2using Aspose.Html;
 3using System.Linq;
 4using Aspose.Html.Converters;
 5using Aspose.Html.Saving;
 6...
 7    // Create an instance of MemoryStreamProvider
 8    using var streamProvider = new MemoryStreamProvider();
 9
10    // Initialize an HTML document
11    using var document = new HTMLDocument(@"<h1>Convert HTML to PDF File Format!</h1>", ".");
12
13    // Convert HTML to PDF using the MemoryStreamProvider
14    Converter.ConvertHTML(document, new PdfSaveOptions(), streamProvider);
15
16    // Get access to the memory stream that contains the result data
17    var memory = streamProvider.Streams.First();
18    memory.Seek(0, SeekOrigin.Begin);
19
20    // Flush the result data to the output PDF file
21    using (FileStream fs = File.Create(Path.Combine(OutputDir, "stream-provider.pdf")))
22    {
23        memory.CopyTo(fs);
24    }

Вы можете скачать полные примеры и файлы данных с GitHub.

Загрузите нашу библиотеку Aspose.HTML для .NET, которая позволит вам успешно, быстро и легко конвертировать HTML, MHTML, EPUB, SVG и Markdown документы в самые популярные форматы.

Aspose.HTML предлагает бесплатный онлайн Конвертер HTML в PDF, который конвертирует HTML в PDF качественно, легко и быстро. Просто загрузите, конвертируйте ваши файлы и получите результат за несколько секунд!

Текст “Баннер HTML в PDF Converter”

Subscribe to Aspose Product Updates

Get monthly newsletters & offers directly delivered to your mailbox.