入門

由 Bit Miracle 翻譯。原文作者：Sergey Bobrovsky

更新於 2026年2月27日

本文介紹了一些基本知識，幫助您快速上手，在 .NET Core、ASP.NET、Windows Forms、WPF、Xamarin、Blazor、Unity 和 HoloLense 應用程式中使用 Docotic.Pdf 程式庫處理 PDF 檔案。

安裝 Docotic.Pdf 庫

透過 NuGet 安裝

最簡單的入門方法是從 NuGet 安裝 BitMiracle.Docotic.Pdf 套件。

如果您是 NuGet 管理員的新手，請參閱這篇快速入門文章。

手動安裝

請從我們的網站下載最新版本的 Docotic.Pdf 庫。我們以 ZIP 壓縮包的形式分發該庫。此壓縮包包含 Docotic.Pdf 庫、所有範例程式碼專案、庫插件和授權協議。

將下載的 ZIP 套件解壓縮到您選擇的位置。

在 Visual Studio 中，開啟「新增參考」對話框，瀏覽到您解壓縮 ZIP 套件的位置，然後從那裡選擇 DLL 檔案。

運行範例程式碼

Docotic.Pdf 的程式碼範例位於 ZIP 套件的 Samples 資料夾中。如果您想使用 C# 語言編寫的範例程式碼，請開啟 SamplesCSharp 解決方案檔案。對於 VB.NET 版本，請開啟 SamplesVB.NET 解決方案檔案。

您可以從我們在GitHub上的範例程式碼庫複製或下載相同的程式碼範例。

請花點時間查看程式碼範例。它應該可以幫助您為應用程式添加 PDF 處理功能。

在您的 .NET 專案中使用 Docotic.Pdf

為了避免輸入庫提供的類型的完全限定名稱，最好將以下 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 的支援非常出色。您可以使用該外掛程式從 HTML、SVG、WEBP 和其他 Web 格式產生 PDF。

如需了解該插件提供的 HTML 轉 PDF API 的更多信息，請閱讀功能概述。該文章介紹如何透過 NuGet 或手動安裝該插件，並包含範例程式碼。

Layout 插件

使用 Layout 外掛程式可以從結構化佈局元素產生 PDF。您可以利用文字跨度、圖像、表格、頁首、頁尾、容器以及（可選的）可重複使用自訂元件來建立文檔，流暢的 Layout API 會自動為您安排所有內容。

您無需將元素放置在固定座標，而是使用簡潔、富有表現力的 API，透過程式碼描述整個文檔，該 API 可根據內容和頁面大小自動調整佈局。佈局引擎隨後會自動處理分頁、巢狀和複雜結構。這使得產生從簡單頁面到複雜 PDF 報告的各種內容變得輕而易舉。

有關使用 Layout API 在 .NET 中生成 PDF 的更多信息，請閱讀本文，其中深入解釋了其功能，並包含安裝說明和範例程式碼。

Gdi插件

允許您在 System.Drawing.Graphics 上列印 PDF 文件或繪製 PDF。您可以從 NuGet 安裝 BitMiracle.Docotic.Pdf.Gdi 套件。或者，您可以手動新增對 ZIP 套件中以下 DLL 的參考：

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

Logging 插件

您可以使用它來記錄 PDF 文件的內部結構資訊。從 NuGet 安裝 BitMiracle.Docotic.Pdf.Logging 套件。或者，手動新增對 ZIP 套件中以下 DLL 的參考：

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

結論

現在，您應該能夠使用 Docotic.Pdf 程式庫在您的應用程式中開發與 PDF 相關的功能了。但這只是個開始。我們建議您閱讀有關該庫的功能並查看程式碼範例。您可能還想訪問Bit Miracle 部落格。