该页面可以包含自动翻译的文本。

入门

本文介绍了一些基础知识,帮助您启动并运行使用 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 博客