استفاده از لایسنس 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";
new Viewer().DoconutLicense(pluginLicensePath);

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

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

using var pluginLicenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var viewer = new Doconut.Viewer();
viewer.DoconutLicense(pluginLicenseStream);

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

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

var viewer = new Viewer();
viewer.DoconutLicense("path/to/your/plugin-license.xml");

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

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

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

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

using Microsoft.Extensions.DependencyInjection;
var docViewer = app.Services.GetRequiredService<Doconut.Viewer>();

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

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

using System.IO;
var licenseFilePath = Path.Combine(path, "path/to/your/license");
var token = await viewer.OpenDocumentAsync(licenseFilePath, new BaseConfig(), new DocOptions(), ct);

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

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

using (var licenseStream = new FileStream("path/to/your/license", FileMode.Open))
{
    var license = new DoconutLicense
    {
        DocBytes = new BinaryReader(licenseStream).ReadBytes((int)licenseStream.Length)
    };
}

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

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

using System.Xml;
using Doconut.Infrastructure.Licensing;

var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
var license = new DoconutLicense(); // ویژگی‌ها را در صورت نیاز از xmlDoc پر کنید

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

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

// مجوزها از طریق تزریق وابستگی پیکربندی می‌شوند؛ نیازی به سازنده صریح نیست.
var viewer = /* نمونه Viewer حل‌شده توسط DI */ null;

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

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

using var licenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var config = new BaseConfig(); // جریان مجوز به‌صورت داخلی توسط BaseConfig مصرف می‌شود

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

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

using System.Xml;
var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
// بارگذاری مجوز دیگر در Doconut.NETStandard 26.9.0 لازم نیست

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

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