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";
Viewer.SetLicensePlugin(pluginLicensePath);

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

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

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

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

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

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

.NET Standard/Core および .NET 6 以降

自動ライセンス検出

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

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

var docViewer = new Viewer(_cache, _accessor);

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

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

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

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

この方法では、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);

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

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

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) オーバーロードを使用し、ストリームでプラグインライセンスを追加します。

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

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

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

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

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

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