Doconutライセンスの使用方法

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

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

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

.NET Framework

自動ライセンス検出

Doconutは、プロジェクト's 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 and .NET 6 and higher

自動ライセンス検出

Doconutは、プロジェクト's 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）を保護するには、ファイルのセキュリティに関するベストプラクティスに従うことが重要です。ライセンスファイルをアクセスが制限された安全なディレクトリに保管し、許可されたユーザーまたはサービスだけが読み取れるようにしてください。