Начало работы

Перевод Bit Miracle. Автор оригинала: Sergey Bobrovsky

Обновлено 23 июня 2026

Эта статья объясняет некоторые основы, которые помогут вам начать обрабатывать PDF-файлы в приложениях .NET Core, ASP.NET, Windows Forms, WPF, Xamarin, Blazor, Unity и HoloLens с библиотекой Docotic.Pdf.

Установка библиотеки Docotic.Pdf

Установка из NuGet

Самый простой способ начать — установить пакет BitMiracle.Docotic.Pdf из NuGet.

Если вы впервые работаете с NuGet Manager, обратитесь к этой статье быстрого старта.

Ручная установка

Скачайте последнюю версию библиотеки Docotic.Pdf с нашего сайта. Мы распространяем библиотеку в виде ZIP-пакета. Пакет содержит библиотеку Docotic.Pdf, все проекты с примерами кода, дополнительные компоненты библиотеки и лицензионные соглашения.

Распакуйте загруженный ZIP-пакет в любое удобное для вас место.

В Visual Studio откройте диалог Add Reference, перейдите к расположению, куда вы распаковали ZIP-пакет, и выберите оттуда DLL.

Запуск примеров кода

Примеры кода для Docotic.Pdf находятся в папке Samples ZIP-пакета. Откройте файл решения SamplesCSharp, если хотите использовать примеры кода, написанные на C#. Для версии VB.NET, пожалуйста, откройте файл решения SamplesVB.NET.

Вы можете клонировать или скачать те же примеры кода из нашего репозитория примеров кода на GitHub.

Пожалуйста, найдите время, чтобы изучить примеры кода. Это поможет вам добавить возможности обработки PDF в ваше приложение.

Использование Docotic.Pdf в вашем проекте .NET

Чтобы не вводить полные имена типов, предоставляемых библиотекой, лучше добавить следующую директиву using в исходный файл C#:

using BitMiracle.Docotic.Pdf;

В VB.NET используйте следующее:

Imports BitMiracle.Docotic.Pdf

В проекте C# добавьте следующий метод в исходный код вашего приложения:

private static void helloPdf()
{
    // замените string.Empty на ваш лицензионный ключ
    BitMiracle.Docotic.LicenseManager.AddLicenseData(string.Empty);

    string outputName = "hello.pdf";
    // в приложении ASP.NET вместо этого используйте следующую строку:
    // string outputName = Server.MapPath("hello.pdf");

    using (PdfDocument pdf = new PdfDocument())
    {
        // рисует "Hello world" на первой странице
        PdfPage firstPage = pdf.Pages[0];
        firstPage.Canvas.DrawString(20, 20, "Hello world!");

        pdf.Save(outputName);
    }

    // открывает сохраненный документ в программе просмотра PDF по умолчанию
    System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo() {
        FileName = outputName,
        UseShellExecute = true,
    });
}

В проекте VB.NET используйте следующий код:

Private Shared Sub helloPdf()
    ' замените string.Empty на ваш лицензионный ключ
    BitMiracle.Docotic.LicenseManager.AddLicenseData(String.Empty)

    Dim outputName As String = "hello.pdf"
    ' в приложении ASP.NET вместо этого используйте следующую строку:
    ' Dim outputName As String = Server.MapPath("hello.pdf")

    Using pdf As New PdfDocument()
        ' рисует "Hello world" на первой странице
        Dim firstPage As PdfPage = pdf.Pages(0)
        firstPage.Canvas.DrawString(20, 20, "Hello world!")

        pdf.Save(outputName)
    End Using

    ' открывает сохраненный документ в программе просмотра PDF по умолчанию
    System.Diagnostics.Process.Start(
        New ProcessStartInfo() With {
            .FileName = outputName,
            .UseShellExecute = True
        }
    )
End Sub

Вызовите метод helloPdf из вашего кода. Это должно создать файл hello.pdf и открыть его в программе просмотра PDF по умолчанию.

Надстройки

Вы можете расширить основную функциональность бесплатными надстройками.

Надстройка HtmlToPdf

Используйте надстройку HtmlToPdf для преобразования HTML в PDF. Надстройка использует Google Chrome и его движок рендеринга Blink, поэтому поддержка HTML5, CSS3 и JavaScript отличная. С помощью надстройки можно генерировать PDF из HTML, SVG, WEBP и других веб-форматов.

Дополнительные сведения об API для преобразования HTML в PDF, предоставляемом надстройкой, см. в обзоре ее возможностей. В статье объясняется, как установить надстройку из NuGet или вручную. Она также содержит примеры кода.

Надстройка Layout

Используйте надстройку Layout для генерации PDF из структурированных элементов макета. Вы компонуете документы из текстовых фрагментов, изображений, таблиц, верхних и нижних колонтитулов, контейнеров и, при необходимости, повторно используемых пользовательских компонентов, а fluent Layout API автоматически располагает все элементы.

Вместо размещения элементов по фиксированным координатам вы описываете целые документы в коде с помощью чистого, выразительного API, который адаптирует макет как к содержимому, так и к размеру страницы. Затем механизм макета автоматически обрабатывает разбиение на страницы, вложенность и сложные структуры. Это позволяет легко создавать все — от простых страниц до сложных PDF-отчетов.

Дополнительные сведения о создании PDF в .NET с помощью Layout API см. в статье, которая подробно объясняет его возможности и содержит инструкции по установке и примеры кода.

Надстройка Gdi

Позволяет печатать PDF-документы или рисовать PDF с помощью System.Drawing.Graphics. Вы можете установить пакет BitMiracle.Docotic.Pdf.Gdi из NuGet. Или вручную добавьте ссылки на следующие DLL из ZIP-пакета:

• BitMiracle.Docotic.Pdf.dll
• Gdi add-on/BitMiracle.Docotic.Pdf.Gdi.dll

Надстройка Logging

Вы можете использовать ее для записи сведений о внутренней структуре PDF-документов. Установите пакет BitMiracle.Docotic.Pdf.Logging из NuGet. Или вручную добавьте ссылки на следующие DLL из ZIP-пакета:

• BitMiracle.Docotic.Pdf.dll
• Logging add-on/BitMiracle.Docotic.Pdf.Logging.dll
• Logging add-on/Microsoft.Extensions.Logging.Abstractions.dll

Заключение

Теперь вы должны быть готовы разрабатывать функции, связанные с PDF, в ваших приложениях с использованием библиотеки Docotic.Pdf. Однако это только начало. Мы рекомендуем прочитать о возможностях библиотеки и изучить примеры кода. Возможно, вам также стоит ознакомиться с блогом Bit Miracle.