استخدام ترخيص Doconut الخاص بك

لمعرفة كيفية استخدام ترخيص Doconut، اتبع الإرشادات أدناه للمنصات المختلفة لـ .NET.

تثبيت ترخيص Doconut

في هذا القسم، ستتعلم كيفية تثبيت وتفعيل ترخيص Doconut الخاص بك عبر بيئات مختلفة، بما في ذلك .NET Framework و .NET Standard/Core و .NET 6. اتبع الخطوات المقدمة لضمان دمج الترخيص بسلاسة في مشروعك:

.NET Framework

اكتشاف الترخيص تلقائيًا

يمكن لـ Doconut اكتشاف التراخيص تلقائيًا إذا تم وضعها داخل مجلد bin الخاص بالمشروع.

إضافة ترخيص افتراضي يدويًا

إذا كنت تفضل إضافة الترخيص يدويًا، الخيارات التالية متاحة:

إضافة ترخيص عن طريق مسار الملف

تستخدم هذه الطريقة التحميل الزائد Viewer.DoconutLicense(string licencePath) لإضافة ترخيص عن طريق تحديد مسار ملف الترخيص.

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

إضافة ترخيص عن طريق تدفق

تستخدم هذه الطريقة التحميل الزائد Viewer.DoconutLicense(Stream licenseStream) لإضافة ترخيص باستخدام تدفق.

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

إضافة ترخيص عن طريق مستند XML

تستخدم هذه الطريقة التحميل الزائد Viewer.DoconutLicense(XMLDocument licence) لإضافة ترخيص باستخدام مستند XML.

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

إضافة ترخيص مكوّن إضافي عن طريق مسار الملف

تستخدم هذه الطريقة التحميل الزائد Viewer.SetLicensePlugin(string pathPluginLicence) لإضافة ترخيص مكوّن إضافي عن طريق تحديد مسار ملف الترخيص المكوّن الإضافي.

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

إضافة ترخيص مكوّن إضافي عن طريق تدفق

تستخدم هذه الطريقة التحميل الزائد Viewer.SetLicensePlugin(Stream pluginLicence) لإضافة ترخيص مكوّن إضافي باستخدام تدفق.

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

إضافة ترخيص مكوّن إضافي عن طريق مستند XML

تستخدم هذه الطريقة التحميل الزائد 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);

إضافة ترخيص عن طريق تدفق

تستخدم هذه الطريقة التحميل الزائد Viewer.DoconutLicense(Stream licenseStream) لإضافة ترخيص باستخدام تدفق.

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

إضافة ترخيص عن طريق مستند XML

تستخدم هذه الطريقة التحميل الزائد 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;

إضافة ترخيص مكوّن إضافي عن طريق تدفق

تستخدم هذه الطريقة التحميل الزائد Viewer.SetLicensePlugin(Stream pluginLicence) لإضافة ترخيص مكوّن إضافي باستخدام تدفق.

using var licenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var config = new BaseConfig(); // يتم استهلاك تدفق الترخيص داخليًا بواسطة BaseConfig

إضافة ترخيص مكوّن إضافي عن طريق مستند XML

تستخدم هذه الطريقة التحميل الزائد 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)، من الضروري اتباع أفضل ممارسات أمان الملفات. احفظ ملف الترخيص في دليل آمن مع وصول مقيد، لضمان أن المستخدمين أو الخدمات المصرح لها فقط يمكنها قراءته.