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 - 在运行时验证许可证

常见做法是检查输出文件是否没有水印。如果许可证文件正确读取,则不会出现水印。


你已经准备好!

  1. 添加 Sheetize.*.lic 文件到项目,并标记为复制到输出文件夹。
  2. 使用任何 Sheetize 功能之前 调用 SetLicense(...)
  3. 部署 许可证文件与二进制文件一起(或通过安全挂载)。

完成上述步骤后,所有 付费的 Sheetize 功能——高级图表、高性能流式处理、多工作表加密等——将在任何使用 C#、VB.NET、C++/CLI 或其他 .NET 支持语言的用户环境中完全解锁。

祝编码愉快!

(*) 此文本取决于版本。