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

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

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

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

1// Convert HTML to PDF using C#
2
3// Invoke the ConvertHTML() method to convert HTML to PDF
4Converter.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. Если вы откроете его в своем браузере, вы должны увидеть:

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

 1// Convert HTML to PDF in C#
 2
 3// Prepare a path to a source HTML file
 4string documentPath = Path.Combine(DataDir, "spring.html");
 5
 6// Prepare a path to save the converted file
 7string savePath = Path.Combine(OutputDir, "spring-output.pdf");
 8
 9// Initialize an HTML document from the file
10using HTMLDocument document = new HTMLDocument(documentPath);
11
12// Initialize PdfSaveOptions
13PdfSaveOptions options = new PdfSaveOptions();
14
15// Convert HTML to PDF
16Converter.ConvertHTML(document, options, savePath);

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

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

Конвертировать 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 с пользовательскими параметрами сохранения:

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

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

• свойство JpegQuality, позволяющее указать качество сжатия изображений в формате JPEG;
• Свойство BackgroundColor, задающее цвет, которым будет заполняться фон. По умолчанию BackgroundColor является прозрачным;
• Свойства HorizontalResolution и VerticalResolution, которые устанавливают разрешение по горизонтали/вертикали для выходных изображений в пикселях на дюйм. По умолчанию эти свойства равны 300 dpi;
• Свойство PageSetup, указывающее размер страницы и поля.

Output Stream Providers

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

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

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

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