使用您的 Doconut 许可证

安装和激活许可证的说明。

了解如何使用 Doconut 许可证，请遵循以下针对不同 .NET 平台的说明。

Doconut 许可证安装

.NET Framework

自动许可证检测

Doconut 可以自动检测放置在项目's 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 and .NET 6 and higher

自动许可证检测

Doconut 可以自动检测放置在项目's 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），务必遵循文件安全的最佳实践。将许可证文件存放在受限访问的安全目录中，确保只有授权用户或服务能够读取它。