Использование вашей лицензии Doconut

Чтобы узнать, как использовать лицензию Doconut, следуйте инструкциям ниже для различных платформ .NET.

Установка лицензии Doconut

В этом разделе вы узнаете, как установить и активировать вашу лицензию Doconut в разных средах, включая .NET Framework, .NET Standard/Core и .NET 6. Следуйте указанным шагам, чтобы обеспечить беспроблемную интеграцию лицензии в ваш проект:

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

Добавить лицензию плагина по потоку

Этот метод использует перегрузку Viewer.SetLicensePlugin(Stream pluginLicence) для добавления лицензии плагина с помощью потока.

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‑документа.

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

.NET Standard/Core и .NET 6 и выше

Автоматическое обнаружение лицензии

Doconut может автоматически обнаруживать лицензии, если они размещены в папке проекта wwwroot.

Чтобы инициализировать docViewer с автоматическим обнаружением лицензии, используйте следующую строку:

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

Добавить лицензию вручную по умолчанию

Вы можете вручную указать путь к единственному файлу лицензии по умолчанию при инициализации просмотрщика.

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) для добавления лицензии с помощью потока.

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‑документа.

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

var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
var license = new DoconutLicense(); // заполнять свойства из xmlDoc по мере необходимости

Вручную добавить несколько лицензий плагинов

Если необходимо указать несколько лицензий, вы можете предоставить список путей к файлам при инициализации просмотрщика.

// Лицензии настраиваются через внедрение зависимостей; явный конструктор не требуется.
var viewer = /* Экземпляр Viewer, разрешённый DI */ null;

Добавить лицензию плагина по потоку

Этот метод использует перегрузку Viewer.SetLicensePlugin(Stream pluginLicence) для добавления лицензии плагина с помощью потока.

using var licenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var config = new BaseConfig(); // Поток лицензии обрабатывается внутренне BaseConfig

Добавить лицензию плагина по XML‑документу

Этот метод использует перегрузку Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) для добавления лицензии плагина с помощью XML‑документа.

using System.Xml;
var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
// Загрузка лицензии больше не требуется в Doconut.NETStandard 26.9.0

Защита файла лицензии

Чтобы обеспечить безопасность вашего файла лицензии Doconut (.lic), необходимо соблюдать лучшие практики защиты файлов. Храните файл лицензии в защищённом каталоге с ограниченным доступом, гарантируя, что только уполномоченные пользователи или сервисы могут его читать.