該頁面可以包含自動翻譯的文字。

入門

本文介紹了一些基礎知識,幫助您啟動並執行使用 Docotic.Pdf 程式庫在 WinForms、控制台或 ASP.NET 應用程 式中處理 PDF 檔案。

Docotic.Pdf 入門

安裝 Docotic.Pdf 庫

從 NuGet 安裝

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

如果您不熟悉 NuGet Manager,請參閱此快速入門文 章

手動安裝

  1. 我們的網站 下載最新版本的 Docotic.Pdf 函式庫。 該庫以 ZIP 套件的形式分發。
    ZIP 套件包含該程式庫的兩個版本:
    • .NET 4.0 及更高版本框架的版本
    • .NET Standard 2.0 及更高版本框架的版本。

    ZIP 套件還包含所有範例項目以及具有許可協議的文件。

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

運行樣品

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

可以從 GitHub 上的範例儲存庫 複製或下載相同的範例程式碼。

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

在 WinForms、控制台或 ASP.NET 應用程式中使用 Docotic.Pdf

  1. 開啟 Visual Studio IDE。 建立一個新項目或開啟現有項目。

  2. 開啟「新增參考」對話方塊並新增對 BitMiracle.Docotic.Pdf.dll 的參考。

    • 如果您已將程式庫新增至 GAC,則擴充功能清單將包含 BitMiracle.Docotic.Pdf 組件
    • 或者,您可以瀏覽到提取 ZIP 套件的位置並從那裡選擇 DLL。

使用「新增引用」對話方塊新增 Docotic.Pdf

請注意,您可以新增對 BitMiracle.Docotic.Pdf 的 NuGet 引用,而不是手動引用其 DLL。

若要存取與 System.Drawing 命名空間和 GDI+ 中的類型提供互通性的方法和屬性,您需要新增對 BitMiracle.Docotic.Pdf.Gdi 擴充 DLL 的參考。 您可以在 ZIP 套件或從 NuGet 安裝 BitMiracle.Docotic.Pdf.Gdi 套件 中找到 DLL。

若要將 HTML 轉換為 PDF(或將 SVG 轉換為 PDF),您需要新增 BitMiracle.Docotic.Pdf.HtmlToPdf 擴充 DLL 的參考。 該 DLL 也在 ZIP 套件中,但我們建議從 NuGet 安裝 BitMiracle.Docotic.Pdf.HtmlToPdf 套 件,而不是手動添加 DLL。

若要使用佈局引擎建立 PDF 文檔,請新增對 BitMiracle.Docotic.Pdf.Layout 擴充 DLL 的參考。 引擎會自動 將內容拆分為頁面,並提供對頁首和頁尾、表格和段落的支援。 您可以在 ZIP 套件中找到 DLL,但我們建議從 NuGet 安裝 BitMiracle.Docotic.Pdf.Layout 套件,而不是手動新增 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 檢視器中開啟它。

預設 PDF 檢視器中的 hello.pdf

結論

現在您應該能夠使用 Docotic.Pdf 程式庫在應用程式中開發 PDF 相關功能。 然而,這只是開始。 我們鼓勵您 仔細閱讀庫附帶的文件並查看範例。 您可能還想查看 Bit Miracle 部落格