使用您的 Doconut 许可证

要了解如何使用 Doconut 许可证，请按照以下针对不同 .NET 平台的说明进行操作。

Doconut 许可证安装

在本节中，您将学习如何在各种环境中安装和激活您的 Doconut 许可证，包括 .NET Framework、.NET Standard/Core 和 .NET 6。请按照提供的步骤操作，以确保将许可证无缝集成到您的项目中：

.NET Framework

自动许可证检测

如果许可证放置在项目的 bin 文件夹中，Doconut 可以自动检测到它们。

添加手动默认许可证

如果您希望手动添加许可证，可使用以下选项：

通过文件路径添加许可证

此方法使用 Viewer.DoconutLicense(string licencePath) 重载，通过指定许可证文件的路径来添加许可证。

csharp

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

通过流添加许可证

此方法使用 Viewer.DoconutLicense(Stream licenseStream) 重载，通过流来添加许可证。

csharp

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

通过 XML 文档添加许可证

此方法使用 Viewer.DoconutLicense(XMLDocument licence) 重载，通过 XML 文档来添加许可证。

csharp

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

通过文件路径添加插件许可证

此方法使用 Viewer.SetLicensePlugin(string pathPluginLicence) 重载，通过指定插件许可证文件的路径来添加插件许可证。

csharp

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

通过流添加插件许可证

此方法使用 Viewer.SetLicensePlugin(Stream pluginLicence) 重载，通过流来添加插件许可证。

csharp

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 文档来添加插件许可证。

csharp

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

.NET Standard/Core 和 .NET 6 及更高版本

自动许可证检测

如果许可证放置在项目的 wwwroot 文件夹中，Doconut 可以自动检测到它们。

要使用自动许可证检测初始化 docViewer，请使用以下代码行：

csharp

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

添加手动默认许可证

在初始化查看器时，您可以手动指定单个默认许可证文件的路径。

csharp

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) 重载，通过流来添加许可证。

csharp

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 文档来添加许可证。

csharp

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

var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
var license = new DoconutLicense(); // 根据需要从 xmlDoc 填充属性

手动默认多个插件许可证

如果需要指定多个许可证，您可以在查看器初始化时提供文件路径列表。

csharp

// 许可证通过依赖注入进行配置；不需要显式构造函数。
var viewer = /* DI‑解析的 Viewer 实例 */ null;

通过流添加插件许可证

此方法使用 Viewer.SetLicensePlugin(Stream pluginLicence) 重载，通过流来添加插件许可证。

csharp

using var licenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var config = new BaseConfig(); // 许可证流在 BaseConfig 内部被消耗

通过 XML 文档添加插件许可证

此方法使用 Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) 重载，通过 XML 文档来添加插件许可证。

csharp

using System.Xml;
var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
// 在 Doconut.NETStandard 26.9.0 中不再需要加载许可证

保护您的许可证文件

为了保护您的 Doconut 许可证文件（.lic），必须遵循文件安全的最佳实践。请将许可证文件存放在受限访问的安全目录中，确保只有授权的用户或服务能够读取它。