Doconut ライセンスの使用方法

Doconut ライセンスの使用方法を確認するには、以下の .NET プラットフォーム別の手順に従ってください。

Doconut ライセンスのインストール

このセクションでは、.NET Framework、.NET Standard/Core、.NET 6 など、さまざまな環境で Doconut ライセンスをインストールおよび有効化する方法を学びます。ライセンスをプロジェクトにシームレスに統合できるよう、以下の手順に従ってください。

.NET Framework

自動ライセンス検出

Doconut は、プロジェクトの bin フォルダーにライセンスが配置されている場合、自動的に検出できます。

手動でデフォルトライセンスを追加

ライセンスを手動で追加したい場合、以下のオプションが利用可能です。

ファイルパスでライセンスを追加

この方法は、Viewer.DoconutLicense(string licencePath) のオーバーロードを使用し、ライセンスファイルへのパスを指定してライセンスを追加します。

var licensePath = "path/to/your/license.lic";
Viewer.DoconutLicense(licensePath);

ストリームでライセンスを追加

この方法は、Viewer.DoconutLicense(Stream licenseStream) のオーバーロードを使用し、ストリームでライセンスを追加します。

using (var licenseStream = new FileStream("path/to/your/license", FileMode.Open))
{
    Viewer.DoconutLicense(licenseStream);
}

XML ドキュメントでライセンスを追加

この方法は、Viewer.DoconutLicense(XMLDocument licence) のオーバーロードを使用し、XML ドキュメントでライセンスを追加します。

var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
Viewer.DoconutLicense(xmlDoc);

ファイルパスでプラグインライセンスを追加

この方法は、Viewer.SetLicensePlugin(string pathPluginLicence) のオーバーロードを使用し、プラグインライセンスファイルへのパスを指定してプラグインライセンスを追加します。

var pluginLicensePath = "path/to/your/plugin-license.lic";
new Viewer().DoconutLicense(pluginLicensePath);

ストリームでプラグインライセンスを追加

この方法は、Viewer.SetLicensePlugin(Stream pluginLicence) のオーバーロードを使用し、ストリームでプラグインライセンスを追加します。

using var pluginLicenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var viewer = new Doconut.Viewer();
viewer.DoconutLicense(pluginLicenseStream);

XML ドキュメントでプラグインライセンスを追加

この方法は、Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) のオーバーロードを使用し、XML ドキュメントでプラグインライセンスを追加します。

var viewer = new Viewer();
viewer.DoconutLicense("path/to/your/plugin-license.xml");

.NET Standard/Core と .NET 6 以降

自動ライセンス検出

Doconut は、プロジェクトの wwwroot フォルダーにライセンスが配置されている場合、自動的に検出できます。

自動ライセンス検出で docViewer を初期化するには、次の行を使用します：

using Microsoft.Extensions.DependencyInjection;
var docViewer = app.Services.GetRequiredService<Doconut.Viewer>();

手動でデフォルトライセンスを追加

ビューアを初期化する際に、単一のデフォルトライセンスファイルへのパスを手動で指定できます。

using System.IO;
var licenseFilePath = Path.Combine(path, "path/to/your/license");
var token = await viewer.OpenDocumentAsync(licenseFilePath, new BaseConfig(), new DocOptions(), ct);

ストリームでライセンスを追加

この方法は、Viewer.DoconutLicense(Stream licenseStream) のオーバーロードを使用し、ストリームでライセンスを追加します。

using (var licenseStream = new FileStream("path/to/your/license", FileMode.Open))
{
    var license = new DoconutLicense
    {
        DocBytes = new BinaryReader(licenseStream).ReadBytes((int)licenseStream.Length)
    };
}

XML ドキュメントでライセンスを追加

この方法は、Viewer.DoconutLicense(XMLDocument licence) のオーバーロードを使用し、XML ドキュメントでライセンスを追加します。

using System.Xml;
using Doconut.Infrastructure.Licensing;

var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
var license = new DoconutLicense(); // 必要に応じて xmlDoc からプロパティを設定します

手動で複数のプラグインライセンスをデフォルトとして設定

複数のライセンスを指定する必要がある場合、ビューアの初期化時にファイルパスのリストを提供できます。

// ライセンスは依存性注入を通じて構成されます; 明示的なコンストラクタは必要ありません。
var viewer = /* DI‑解決された Viewer インスタンス */ null;

ストリームでプラグインライセンスを追加

この方法は、Viewer.SetLicensePlugin(Stream pluginLicence) のオーバーロードを使用し、ストリームでプラグインライセンスを追加します。

using var licenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var config = new BaseConfig(); // ライセンスストリームは BaseConfig によって内部で消費されます

XML ドキュメントでプラグインライセンスを追加

この方法は、Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) のオーバーロードを使用し、XML ドキュメントでプラグインライセンスを追加します。

using System.Xml;
var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
// Doconut.NETStandard 26.9.0 ではライセンスのロードは不要になりました

ライセンスファイルの保護

Doconut ライセンスファイル（.lic）を保護するには、ファイルセキュリティのベストプラクティスに従うことが重要です。ライセンスファイルをアクセスが制限された安全なディレクトリに保存し、権限のあるユーザーまたはサービスのみが読み取れるようにしてください。