Эта страница может содержать автоматически переведенный текст.

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

В этой статье объясняются некоторые основы, которые помогут вам начать обрабатывать PDF-файлы при помощи библиотеки Docotic.Pdf в вашем WinForms, консольном или ASP.NET-приложении.

Начало работы с Docotic.Pdf

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

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

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

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

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

  1. Загрузите последнюю версию Docotic.Pdf с нашего сайта. Библиотека распространяется в виде ZIP-пакета. ZIP-пакет содержит две версии библиотеки:
    • версия для платформ .NET 4.0 и более поздних версий
    • версия для платформ .NET Standard 2.0 и более поздних версий.

    ZIP-пакет также содержит все примеры проектов и файл с лицензионным соглашением.

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

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

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

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

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

Использование Docotic.Pdf в консольном, WinForms- или ASP.NET-приложении

  1. Откройте интегрированную среду разработки Visual Studio. Создайте новый проект или откройте существующий.

  2. Откройте диалоговое окно «Добавить ссылку» и добавьте ссылку на BitMiracle.Docotic.Pdf.dll.

    • Список в разделе «Расширения» будет содержать сборку BitMiracle.Docotic.Pdf, если вы добавили библиотеку в GAC.
    • Либо вы можете перейти в папку, в которую вы распаковали ZIP-пакет, и выбрать DLL оттуда.

Добавление Docotic.Pdf с помощью диалогового окна «Добавить ссылку»

Обратите внимание, что вы можете добавить ссылку NuGet на BitMiracle.Docotic.Pdf вместо того чтобы вручную добавлять ссылку на DLL.

Для доступа к методам и свойствам, обеспечивающим взаимодействие с типами из пространство имен System.Drawing и GDI+, вам будет нужно добавить ссылку на DLL дополнения BitMiracle.Docotic.Pdf.Gdi. Вы можете найти эту DLL в ZIP-архиве или установить пакет BitMiracle.Docotic.Pdf.Gdi с NuGet.

Чтобы преобразовывать HTML в PDF (или SVG в PDF), вам необходимо добавить ссылку на DLL дополнения BitMiracle.Docotic.Pdf.HtmlToPdf. DLL этого дополнения также находится в ZIP-архиве, но мы рекомендуем установить пакет BitMiracle.Docotic.Pdf.HtmlToPdf из NuGet вместо добавления DLL вручную.

Чтобы создавать документы PDF с помощью системы вёрстки, добавьте ссылку на файл BitMiracle.Docotic.Pdf.Layout.dll. Система автоматически разбивает контент на страницы и обеспечивает поддержку верхних и нижних колонтитулов страниц, таблиц и абзацев. Вы можете найти DLL в ZIP-архиве, но мы рекомендуем установить пакет BitMiracle.Docotic.Pdf.Layout из NuGet вместо добавления DLL вручную.

  1. Чтобы не вводить полные ссылки на dll, лучше всего добавить следующий оператор using к уже существующим в вашем исходном файле на C#
    using BitMiracle.Docotic.Pdf;
    

    В VB.NET делайте так:

    Imports BitMiracle.Docotic.Pdf
    
  2. В проекте на 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
  1. Вызовите метод helloPdf() из вашего кода. Это должно создать файл hello.pdf и открыть его в вашем просмотрщике PDF по умолчанию.

hello.pdf в программе просмотра PDF по умолчанию

Заключение

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