Doconut ライセンスの使用方法

ライセンスのインストールと有効化の手順。

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

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

.NET Framework

自動ライセンス検出

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

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

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

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

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

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

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

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

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

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

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

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

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

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

C#
var pluginLicensePath = "path/to/your/plugin-license.lic";
Viewer.SetLicensePlugin(pluginLicensePath);

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

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

C#
using (var pluginLicenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open))
{
    Viewer.SetLicensePlugin(pluginLicenseStream);
}

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

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

C#
var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
Viewer.SetLicensePlugin(pluginXmlDoc);

.NET Standard/Core と .NET 6 以降

自動ライセンス検出

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

自動ライセンス検出で docViewer を初期化するには、次の行を使用してください。

C#
var docViewer = new Viewer(_cache, _accessor);

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

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

C#
var licenseFilePath = Path.Combine(_hostingEnvironment.WebRootPath, "path/to/your/license");
var docViewer = new Viewer(_cache, _accessor, licenseFilePath);

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

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

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

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

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

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

手動でデフォルトの複数プラグインライセンスを追加

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

C#
List<string> licenseFilePaths = new List<string>
{
    Path.Combine(_hostingEnvironment.WebRootPath, "Doconut.Viewer.lic"),
    Path.Combine(_hostingEnvironment.WebRootPath, "Doconut.Viewer.Annotation.lic"),
    Path.Combine(_hostingEnvironment.WebRootPath, "Doconut.Viewer.Search.lic")
};
var docViewer = new Viewer(_cache, _accessor, licenseFilePaths);

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

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

C#
using (var pluginLicenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open))
{
    Viewer.SetLicensePlugin(pluginLicenseStream);
}

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

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

C#
var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
Viewer.SetLicensePlugin(pluginXmlDoc);

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

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