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 中)。
运行示例
- 在 Visual Studio 中打开解决方案文件
Example.sln
。 - 在解决方案资源管理器中选择一个示例项目,并将其设置为启动项目。目前提供了 C# 和 Visual Basic 示例。
- 构建并运行示例。
或者您也可以在项目文件夹中打开命令行工具并通过命令运行示例:
dotnet run
将 ComPDFKit 集成到项目中
可以按照下面所述的手动或 nuget 集成方式进行操作。本节将帮助您构建您的第一个 ComPDFKit 应用程序。如果您能够打开、保存和关闭 PDF文件,则可以轻松集成 ComPDFKit PDF SDK 的其余部分。
手动集成
- 启动 Visual Studio 2022 的新实例并创建新的 .NET Core 控制台应用程序(File > New > Project...),然后点击 OK 确认创建项目。
- 在屏幕右侧找到解决方案管理器,选择项目并按下快捷键
Alt + Enter
或右击项目并在菜单中点击“属性"选项,这将打开属性选项卡。
确认已经使用”.NET Core 2.1“(或更高版本)作为应用程序的目标框架。
- 右键单击”Dependencies“,然后单击”Add Project Reference“,这将打开”Reference Manager“对话框。单击对话框底部的选项,找到对应的”ComPDFKit.NET.dll“选择并单击添加。
- 在解决方案资源管理器中,选择项目并按
Shift + Alt + A
。这样您就可以添加现有项目。
或者,您可以右键单击该项目并在子菜单Add an existing item...
下找到该选项Add
。
再次导航到库所在位置,选择文件类型为All Files (*.*)
并选择ComPDFKitNative.dll
。单击“添加”。
- 在解决方案资源管理器中选择 .dll。下方会出现一个属性窗口,在其中,将构建操作更改为 Content。将复制到输出目录设置更改为
Copy always
。
使用 Nuget 包集成
执行手动集成的前两个步骤。
右键单击项目依赖项,然后单击
Manage Nuget Packages...
,这将打开 Nuget 包管理器。单击 Browse 包管理器顶部附近的选项卡,在搜索栏中输入:
ComPDFKit.NetCore
选择
ComPDFKit.NetCore
包,然后单击Install
面板中包含软件包信息的按钮。如果出现提示或打开外部对话框进行确认,请单击 OK。安装完成后,您将可以在解决方案资源管理器中的 Dependencies 下看到对该包的引用。
创建 PDF 文档
我们已经完成了所有准备步骤。现在让我们使用 ComPDFKit PDF SDK 创建一个带有一个空白页的 PDF 文件,用下面这段代码替换您的 Program.cs 文件,注意:需要将您的 license 替换到 LicenseVerify()
方法中。
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");
}
}
}