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

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

نصب لایسنس Doconut

در این بخش، نحوه نصب و فعال‌سازی لایسنس Doconut خود را در محیط‌های مختلف از جمله .NET Framework، .NET Standard/Core و .NET 6 یاد می‌گیرید. مراحل ارائه‌شده را دنبال کنید تا لایسنس شما به‌صورت یکپارچه در پروژه‌تان ادغام شود:

.NET Framework

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

var docViewer = new Viewer(_cache, _accessor);

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

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

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

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

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

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

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

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

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

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

اگر نیاز به مشخص کردن چندین لایسنس دارید، می‌توانید فهرستی از مسیرهای فایل را به مقداردهی اولیه Viewer بدهید.

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 استفاده می‌کند.

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

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

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

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

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

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