Использование вашей лицензии 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";
Viewer.SetLicensePlugin(pluginLicensePath);

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

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

csharp

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

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

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

csharp

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

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

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

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

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

csharp

var docViewer = new Viewer(_cache, _accessor);

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

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

csharp

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

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

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

csharp

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

Добавить лицензию через XML-документ

csharp

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

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

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

csharp

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);

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

csharp

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

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

csharp

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

Защита вашего файла лицензии

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