Setup License
为 Sheetize 设置许可证文件
目标: 加载有效的许可证文件,使 Sheetize NuGet/DLL 库解锁所有高级功能。
以下步骤适用于任何 .NET 语言(C#、VB.NET、C++、F# 等),以及通过 NuGet 或直接添加已编译的 .dll 引用 Sheetize 的项目。
1 - 获取许可证文件
| 来源 | 获取方式 |
|---|---|
| 购买页面 | 结账后下载 Sheetize.*.lic。 |
重要提示: 将文件保存在 只读 位置,并确保随部署一起包含,或放在可执行文件旁的安全文件夹中。不要将许可证文件提交到公共源码仓库,以免被滥用。
2 - 将许可证文件添加到项目中(可选)
| IDE / 构建系统 | 步骤 |
|---|---|
| Visual Studio(任何 .NET 项目) | 1. 右键点击项目 → Add → Existing Item,选择 Sheetize.(*).lic。 |
| 2. 将 Build Action 设置为 Content。 | |
| 3. 将 Copy to Output Directory 设置为 Copy if newer(或 Copy always)。 |
提示: 如果有多个环境(开发、测试、生产),可以为每个文件夹保留单独的许可证文件(
licenses/dev/、licenses/prod/),并在构建时使用 Condition 属性复制相应的文件。
3 - 使用许可证文件初始化 Sheetize
Sheetize 库要求在使用任何其他 Sheetize API 之前,调用一次 LicenseManager.Load(string path) 来加载许可证文件。以下是语言特定的代码片段。
C#(最常用)
using Sheetize; // Namespace of the library
using System;
using System.IO;
public static class Program
{
private static void Main()
{
// Path is relative to the running EXE's folder (where the file was copied)
string licensePath = "/path/to/Sheetize.PdfConverter_for_.NET.lic";
License license = new Sheetize.License();
license.SetLicense(licensePath);
// Now you can use premium features
var loadOptions = new LoadOptions
{
InputFile = "/path/to/sample.xlsx"
};
var saveOptions = new SpreadsheetSaveOptions
{
OutputFile = "/path/to/sample.pdf"
};
SpreadsheetConverter.Process(loadOptions, saveOptions);
// .
}
}4 - 在运行时验证许可证
常见做法是检查输出文件是否没有水印。如果许可证文件正确读取,则不会出现水印。
你已经准备好!
- 添加
Sheetize.*.lic文件到项目,并标记为复制到输出文件夹。 - 在 使用任何 Sheetize 功能之前 调用
SetLicense(...)。 - 部署 许可证文件与二进制文件一起(或通过安全挂载)。
完成上述步骤后,所有 付费的 Sheetize 功能——高级图表、高性能流式处理、多工作表加密等——将在任何使用 C#、VB.NET、C++/CLI 或其他 .NET 支持语言的用户环境中完全解锁。
祝编码愉快!
(*) 此文本取决于版本。