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

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

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

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

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

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

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

// Prepare a path to a source HTML file
string documentPath = Path.Combine(DataDir, "spring.html");

// Prepare a path to save the converted file
string savePath = Path.Combine(OutputDir, "spring-output.pdf");

// Initialize an HTML document from the file
using var document = new HTMLDocument(documentPath);

// Initialize PdfSaveOptions 
var options = new PdfSaveOptions();

// Convert HTML to PDF
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, вы должны выполнить несколько шагов:

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

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

// Prepare a path to a source HTML file
string documentPath = Path.Combine(DataDir, "drawing.html");

// Prepare a path to save the converted file
string savePath = Path.Combine(OutputDir, "drawing-options.pdf");

// Initialize an HTML document from the file
using var document = new HTMLDocument(documentPath);

// Initialize PdfSaveOptions. Set up the page-size 600x300 pixels, margins, resolutions and change the background color to AliceBlue 
var options = new PdfSaveOptions()
{                
    HorizontalResolution = 200,
    VerticalResolution = 200,
    BackgroundColor = System.Drawing.Color.AliceBlue,
    JpegQuality = 100
};
options.PageSetup.AnyPage = new Page(new Aspose.Html.Drawing.Size(600, 300), new Margin(20, 10, 10, 10));           

// Convert HTML to PDF
Converter.ConvertHTML(document, options, savePath);

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

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

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

• Как изменить размер документа во время преобразования из HTML?
• Как свести PDF
• Установить папку шрифтов для рендеринга HTML в PDF
• Объединить HTML в PDF
• Время ожидания сети для преобразования HTML

Output Stream Providers

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

class MemoryStreamProvider : Aspose.Html.IO.ICreateStreamProvider
{
    // List of MemoryStream objects created during the document rendering
    public List<MemoryStream> Streams { get; } = new List<MemoryStream>();

    public Stream GetStream(string name, string extension)
    {
        // This method is called when only one output stream is required, for instance for XPS, PDF or TIFF formats
        MemoryStream result = new MemoryStream();
        Streams.Add(result);
        return result;
    }

    public Stream GetStream(string name, string extension, int page)
    {
        // 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.)
        MemoryStream result = new MemoryStream();
        Streams.Add(result);
        return result;
    }

    public void ReleaseStream(Stream stream)
    {
        // Here you can release the stream filled with data and, for instance, flush it to the hard-drive
    }

    public void Dispose()
    {
        // Releasing resources
        foreach (var stream in Streams)
            stream.Dispose();
    }
}

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

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

// Create an instance of MemoryStreamProvider
using var streamProvider = new MemoryStreamProvider();

// Initialize an HTML document
using var document = new HTMLDocument(@"<h1>Convert HTML to PDF File Format!</h1>", ".");

// Convert HTML to PDF using the MemoryStreamProvider
Converter.ConvertHTML(document, new PdfSaveOptions(), streamProvider);

// Get access to the memory stream that contains the result data
var memory = streamProvider.Streams.First();
memory.Seek(0, SeekOrigin.Begin);

// Flush the result data to the output file
using (FileStream fs = File.Create(Path.Combine(OutputDir, "stream-provider.pdf")))
{
    memory.CopyTo(fs);
}

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

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

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