Конвертировать 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-документа). Это могут быть разные сценарии, но это можно сделать с помощью нескольких обязательных шагов:
- Загрузите файл HTML с помощью одного из конструкторов HTMLDocument() класса HTMLDocument. В примере мы используем конструктор HTMLDocument(string), который инициализирует HTML-документ из файла.
- Создайте новый объект PdfSaveOptions.
- Используйте метод ConvertHTML() класса Converter для сохранения HTML в виде файла PDF. Вам нужно передать HTMLDocument, PdfSaveOptions и путь к выходному файлу методу ConvertHTML() для преобразования HTML в PDF.
Чтобы продолжить работу с этим руководством, нам понадобится файл HTML для работы. Вот пример HTML-файла, который мы будем использовать в следующем примере C# – 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 и т. д.
Property | Description |
---|---|
JpegQuality | Specifies the quality of JPEG compression for images. The default value is 95. |
Css | Gets a CssOptions object which is used for configuration of CSS properties processing. |
DocumentInfo | This property contains information about the output PDF document. |
BackgroundColor | This property sets the color that will fill the background of every page. By default, this property is Transparent. |
PageSetup | This property gets a page setup object and uses it for configuration output page-set. |
HorizontalResolution | Sets horizontal resolution for output images in pixels per inch. The default value is 300 dpi. |
VerticalResolution | Sets vertical resolution for output images in pixels per inch. The default value is 300 dpi. |
Encryption | This 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, вы должны выполнить несколько шагов:
- Загрузите файл HTML с помощью одного из конструкторов HTMLDocument() класса HTMLDocument.
- Создайте новый объект PdfSaveOptions и укажите необходимые свойства. Класс PdfSaveOptions предоставляет множество свойств, которые дают вам полный контроль над широким спектром параметров и улучшают процесс преобразования HTML в формат PDF.
- Используйте метод
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);
В приведенном выше примере мы используем:
- свойство
JpegQuality
, позволяющее указать качество сжатия изображений в формате JPEG; - Свойство
BackgroundColor
, задающее цвет, которым будет заполняться фон. По умолчаниюBackgroundColor
является прозрачным; - Свойства
HorizontalResolution
иVerticalResolution
, которые устанавливают разрешение по горизонтали/вертикали для выходных изображений в пикселях на дюйм. По умолчанию эти свойства равны 300 dpi; - Свойство
PageSetup
, указывающее размер страницы и поля.
Преобразование 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 качественно, легко и быстро. Просто загрузите, конвертируйте ваши файлы и получите результат за несколько секунд!