Skip to content

Windows 集成 .NET Core 库

环境要求

  • Visual Studio

    确保 .NET Core cross-platform development 工作负载 和 MSBUILD 是您安装的一部分。

    如果您想使用适用于 Windows x64 的 NuGet 集成,请确保您拥有 Visual Studio 2017 或更高版本。

    注意:ComPDFKit PDF SDK 是多目标的,支持的目标框架包括: .NET Core 2.1+, .NET Standard 2.0, .NET 5, .NET 6, .NET 7, .NET 8。

  • 适用于 Windows 的 ComPDFKit PDF SDK for .NET Core 库

    联系我们以获取 ComPDFKit PDF SDK for .NET Core。

  • ComPDFKit PDF SDK 许可证

    在生产环境中使用需要商业许可证密钥。如果您没有有效的许可证密钥,请联系我们以获取许可证密钥。

    许可证密钥是唯一生成的,小心保管您的许可证密钥以避免在错误的环境中公开(例如在您的公共 GitHub 中)。

运行示例

  1. 在 Visual Studio 中打开解决方案文件 Example.sln
  2. 在解决方案资源管理器中选择一个示例项目,并将其设置为启动项目。目前提供了 C# 和 Visual Basic 示例。
  3. 构建并运行示例。

或者您也可以在项目文件夹中打开命令行工具并通过命令运行示例:

powershell
dotnet run

将 ComPDFKit 集成到项目中

可以按照下面所述的手动或 nuget 集成方式进行操作。本节将帮助您构建您的第一个 ComPDFKit 应用程序。如果您能够打开、保存和关闭 PDF文件,则可以轻松集成 ComPDFKit PDF SDK 的其余部分。

手动集成

  1. 启动 Visual Studio 2022 的新实例并创建新的 .NET Core 控制台应用程序(File > New > Project...),然后点击 OK 确认创建项目。

Create New Project

  1. 在屏幕右侧找到解决方案管理器,选择项目并按下快捷键 Alt + Enter或右击项目并在菜单中点击“属性"选项,这将打开属性选项卡。

确认已经使用”.NET Core 2.1“(或更高版本)作为应用程序的目标框架。

Version

  1. 右键单击”Dependencies“,然后单击”Add Project Reference“,这将打开”Reference Manager“对话框。单击对话框底部的选项,找到对应的”ComPDFKit.NET.dll“选择并单击添加。

Add Reference

  1. 在解决方案资源管理器中,选择项目并按Shift + Alt + A。这样您就可以添加现有项目。

或者,您可以右键单击该项目并在子菜单Add an existing item...下找到该选项Add

再次导航到库所在位置,选择文件类型为All Files (*.*) 并选择ComPDFKitNative.dll。单击“添加”。

  1. 在解决方案资源管理器中选择 .dll。下方会出现一个属性窗口,在其中,将构建操作更改为 Content。将复制到输出目录设置更改为 Copy always

Copy Always

使用 Nuget 包集成

  1. 执行手动集成的前两个步骤。

  2. 右键单击项目依赖项,然后单击 Manage Nuget Packages...,这将打开 Nuget 包管理器。

  3. 单击 Browse 包管理器顶部附近的选项卡,在搜索栏中输入:

    ComPDFKit.NetCore
  4. 选择 ComPDFKit.NetCore 包,然后单击 Install 面板中包含软件包信息的按钮。如果出现提示或打开外部对话框进行确认,请单击 OK。

    安装完成后,您将可以在解决方案资源管理器中的 Dependencies 下看到对该包的引用。

创建 PDF 文档

我们已经完成了所有准备步骤。现在让我们使用 ComPDFKit PDF SDK 创建一个带有一个空白页的 PDF 文件,用下面这段代码替换您的 Program.cs 文件,注意:需要将您的 license 替换到 LicenseVerify() 方法中。

csharp

using ComPDFKit.NativeMethod;
using ComPDFKit.PDFDocument;
using Microsoft.Win32;
using System.Reflection.Metadata;
using System.Windows;

namespace ComPDFKit_Demo
{
    public class Program
    {
        private static bool LicenseVerify()
        {
            if (!CPDFSDKVerifier.LoadNativeLibrary())
                return false;
            LicenseErrorCode verifyResult = CPDFSDKVerifier.LicenseVerify("Input your license here");
            return (verifyResult == LicenseErrorCode.E_LICENSE_SUCCESS);
        }
        
        public static void Main()
        { 
            LicenseVerify();
            CPDFDocument document = CPDFDocument.CreateDocument();
             // 插入到第一页。
			int pageIndex = 0;
			int pageWidth = 595;
			int pageHeight = 842;
			// InsertPage方法可以指定一个图片路径,当图片路径为空时即插入空白页面。
			document.InsertPage(pageIndex, pageWidth, pageHeight, "");
			document.WriteToFilePath("new_file.pdf");// 将文档对象全量保存到当前路径
            Console.WriteLine("Done. Results saved in new_file.pdf");
        }
    }
}