Sheetize のライセンスファイル設定
目的: 有効なライセンスファイルを読み込み、Sheetize の NuGet/DLL ライブラリのすべてのプレミアム機能を解除することが目的です。
以下の手順は、.NET 言語 (C#、VB.NET、C++、F# など) にかかわらず、Sheetize を NuGet 経由またはコンパイル済み .dll を直接追加して参照しているプロジェクトでも使用できます。
1 - ライセンスファイルの取得
| 取得先 | 取得方法 |
|---|---|
| 購入ページ | 購入後に Sheetize.*.lic をダウンロードしてください。 |
重要: ファイルは読み取り専用の場所に保存し、デプロイに含めるか、実行ファイルの隣の安全なフォルダーに置いてください。ライセンスファイルをパブリックリポジトリにコミットして、悪用されないようにしないでください。
2 - ライセンスファイルをプロジェクトに追加 (任意)
| IDE / ビルドシステム | 手順 |
|---|---|
| Visual Studio (任意の .NET プロジェクト) | 1. プロジェクトを右クリック → 追加 → 既存項目 を選択し、Sheetize(*).lic を選びます。 |
| 2. ビルドアクション を 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(...)を 呼び出します。 - ライセンスファイルをバイナリと一緒にデプロイします(または安全なマウント経由で提供)。
これらの手順を実行すれば、ユーザーは C#、VB.NET、C++/CLI など、どの .NET 対応言語でコードを書いていても、有料の Sheetize 機能(高度なチャート、ハイパフォーマンス・ストリーミング、マルチシート暗号化など)がすべて完全に利用可能になります。
コーディングを楽しんでください!
(※)このテキストはエディションに依存します。