Використання вашої ліцензії Doconut

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

Встановлення ліцензії Doconut

У цьому розділі ви дізнаєтеся, як встановити та активувати вашу ліцензію Doconut у різних середовищах, включаючи .NET Framework, .NET Standard/Core та .NET 6. Дотримуйтесь наведених кроків, щоб забезпечити безперешкодну інтеграцію вашої ліцензії у ваш проєкт:

.NET Framework

Автоматичне виявлення ліцензії

Doconut може автоматично виявляти ліцензії, якщо вони розташовані у папці bin проєкту.

Додати ліцензію за замовчуванням вручну

Якщо ви віддаєте перевагу додавати ліцензію вручну, доступні наступні варіанти:

Додати ліцензію за шляхом до файлу

Цей метод використовує перевантаження 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 і вище

Автоматичне виявлення ліцензії

Doconut може автоматично виявляти ліцензії, якщо вони розташовані у папці wwwroot проєкту.

Щоб ініціалізувати 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‑документом

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‑resolved екземпляр Viewer */ null;

Додати ліцензію плагіна за допомогою потоку

csharp

using var licenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var config = new BaseConfig(); // потік ліцензії споживається внутрішньо BaseConfig

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

csharp

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

Захист вашого файлу ліцензії

Щоб захистити ваш файл ліцензії Doconut (.lic), важливо дотримуватись найкращих практик безпеки файлів. Зберігайте файл ліцензії у захищеній директорії з обмеженим доступом, гарантуючи, що лише уповноважені користувачі або служби можуть його читати.