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