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

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

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

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

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

Ознакомьтесь с этой краткой статьей если вы новичок в работе с NuGet Manager.

Установка вручную

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

Извлеките загруженный ZIP-пакет в любое место по вашему выбору.

В Visual Studio откройте диалоговое окно «Добавить ссылку», перейдите в папку, в которую вы извлекли ZIP-пакет, и выберите оттуда DLL.

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

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

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

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

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

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

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

Позволяет конвертировать HTML в PDF (или SVG/WEBP в PDF). Вы можете установить пакет BitMiracle.Docotic.Pdf.HtmlToPdf из NuGet. Или вручную добавьте ссылки на следующие библиотеки DLL из ZIP-пакета:

• BitMiracle.Docotic.Pdf.dll
• HtmlToPdf add-on/BitMiracle.Docotic.Pdf.HtmlToPdf.dll
• HtmlToPdf add-on/Microsoft.Bcl.AsyncInterfaces.dll

Дополнение Layout

Используйте надстройку для генерации документов PDF на основе дизайна, определенного в коде. Используйте стандартные блоки, такие как страницы, контейнеры, изображения, абзацы текста и т. д., для создания PDF-файлов любой сложности.

Надстройка разметки автоматически разбивает контент на страницы и обеспечивает поддержку верхних и нижних колонтитулов, таблиц и абзацев. Установите пакет BitMiracle.Docotic.Pdf.Layout из NuGet. Или вручную добавьте ссылки на следующие библиотеки DLL из ZIP-пакета:

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

Дополнение 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.