開始使用

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

更新於 2026年6月23日

本文說明一些基礎知識，協助您開始在 .NET Core、ASP.NET、Windows Forms、WPF、Xamarin、Blazor、Unity 和 HoloLens 應用程式中使用 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

為了避免輸入函式庫提供型別的完整限定名稱，最好在您的 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 附加元件

使用 HtmlToPdf 附加元件將 HTML 轉換為 PDF。此附加元件使用 Google Chrome 及其 Blink 渲染引擎，因此對 HTML5、CSS3 和 JavaScript 的支援非常好。您可以使用此附加元件從 HTML、SVG、WEBP 及其他網頁格式產生 PDF。

如需附加元件提供的 HTML 轉 PDF API 的詳細資訊，請閱讀其功能概覽。本文說明如何從 NuGet 或手動安裝附加元件，也包含範例程式碼。

Layout 附加元件

使用 Layout 附加元件從結構化版面元素產生 PDF。您可以使用文字片段、影像、表格、頁首、頁尾、容器，以及可選的可重複使用自訂元件來組合文件，而流暢式 Layout API 會為您安排好一切。

您不必將元素放在固定座標，而是可以使用簡潔、具表達力的 API 以程式碼描述整份文件，讓版面配置同時適應內容與頁面大小。接著版面引擎會自動處理分頁、巢狀結構與複雜結構。這讓您可以輕鬆產生從簡單頁面到進階 PDF 報表的各種內容。

如需使用 Layout API 在 .NET 中產生 PDF 的詳細資訊，請閱讀說明其功能細節並包含安裝指示與範例程式碼的文章。

Gdi 附加元件

可讓您列印 PDF 文件，或在 System.Drawing.Graphics 上繪製 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 部落格。