استخدام لایسنس Doconut

دستورالعمل‌های نصب و فعال‌سازی لایسنس شما.

برای یافتن نحوه استفاده از لایسنس Doconut، دستورالعمل‌های زیر را برای پلتفرم‌های مختلف .NET دنبال کنید.

نصب لایسنس Doconut

.NET Framework

تشخیص خودکار لایسنس

دوکونت می‌تواند لایسنس‌ها را به‌صورت خودکار در پوشه bin پروژه تشخیص دهد.

افزودن لایسنس به‌صورت دستی

اگر ترجیح می‌دهید لایسنس را به‌صورت دستی اضافه کنید، گزینه‌های زیر موجود است:

افزودن لایسنس با مسیر فایل

این روش از overload Viewer.DoconutLicense(string licencePath) برای افزودن لایسنس از مسیر فایل استفاده می‌کند.

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

افزودن لایسنس با Stream

این روش از overload Viewer.DoconutLicense(Stream licenseStream) برای افزودن لایسنس با یک Stream استفاده می‌کند.

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

افزودن لایسنس با سند XML

این روش از overload Viewer.DoconutLicense(XMLDocument licence) برای افزودن لایسنس از یک سند XML استفاده می‌کند.

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

افزودن لایسنس افزونه با مسیر فایل

این روش از overload Viewer.SetLicensePlugin(string pathPluginLicence) برای افزودن لایسنس افزونه از مسیر فایل استفاده می‌کند.

C#
var pluginLicensePath = "path/to/your/plugin-license.lic";
Viewer.SetLicensePlugin(pluginLicensePath);

افزودن لایسنس افزونه با Stream

این روش از overload Viewer.SetLicensePlugin(Stream pluginLicence) برای افزودن لایسنس افزونه با یک Stream استفاده می‌کند.

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

افزودن لایسنس افزونه با سند XML

این روش از overload Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) برای افزودن لایسنس افزونه از یک سند XML استفاده می‌کند.

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

.NET Standard/Core و .NET 6 و بالاتر

تشخیص خودکار لایسنس

دوکونت می‌تواند لایسنس‌ها را به‌صورت خودکار در پوشه wwwroot برنامه تشخیص دهد.

برای مقداردهی اولیه docViewer با تشخیص خودکار لایسنس، از خط زیر استفاده کنید:

C#
var docViewer = new Viewer(_cache, _accessor);

افزودن لایسنس به‌صورت دستی

می‌توانید مسیر یک فایل لایسنس پیش‌فرض را هنگام مقداردهی اولیه viewer مشخص کنید.

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

افزودن لایسنس با Stream

این روش از overload Viewer.DoconutLicense(Stream licenseStream) برای افزودن لایسنس با یک Stream استفاده می‌کند.

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

افزودن لایسنس با سند XML

این روش از overload Viewer.DoconutLicense(XMLDocument licence) برای افزودن لایسنس از یک سند XML استفاده می‌کند.

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

افزودن چند لایسنس افزونه به‌صورت پیش‌فرض

اگر نیاز به تعیین چند لایسنس دارید، می‌توانید لیستی از مسیرهای فایل را به مقداردهی اولیه viewer بدهید.

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

افزودن لایسنس افزونه با Stream

این روش از overload Viewer.SetLicensePlugin(Stream pluginLicence) برای افزودن لایسنس افزونه با یک Stream استفاده می‌کند.

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

افزودن لایسنس افزونه با سند XML

این روش از overload Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) برای افزودن لایسنس افزونه از یک سند XML استفاده می‌کند.

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

حفاظت از فایل لایسنس شما

برای محافظت از فایل لایسنس Doconut (.lic) لازم است بهترین شیوه‌های امنیتی را رعایت کنید. فایل لایسنس را در مسیری امن با دسترسی محدود ذخیره کنید تا تنها کاربران یا سرویس‌های مجاز بتوانند آن را بخوانند.