استفاده از لایسنس Doconut شما

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

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

نصب لایسنس Doconut

.NET Framework

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

Doconut می‌تواند لایسنس‌ها را به‌صورت خودکار تشخیص دهد اگر در پوشهٔ 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 و بالاتر

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

Doconut می‌تواند لایسنس‌ها را به‌صورت خودکار تشخیص دهد اگر در پوشهٔ 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) ضروری است که بهترین شیوه‌های امنیت فایل را رعایت کنید. فایل لایسنس را در دایرکتوری امنی با دسترسی محدود ذخیره کنید به‌طوری که فقط کاربران یا سرویس‌های مجاز بتوانند آن را بخوانند.