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

تعليمات تثبيت وتنشيط رخصتك.

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

تثبيت رخصة Doconut

.NET Framework

الكشف التلقائي عن الرخصة

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

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

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

إضافة رخصة عبر مسار الملف

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

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

إضافة رخصة عبر تدفق

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

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

إضافة رخصة عبر مستند XML

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

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

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

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

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

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

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

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

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

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

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

يمكنك تحديد مسار ملف رخصة افتراضية واحدة يدويًا عند تهيئة العارض.

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

إضافة رخصة عبر تدفق

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

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

إضافة رخصة عبر مستند XML

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

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

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

إذا كنت بحاجة لتحديد عدة رخص، يمكنك تقديم قائمة بمسارات الملفات إلى تهيئة العارض.

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);

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

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

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

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

تستخدم هذه الطريقة الدالة Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) لإضافة رخصة مكوّن إضافي باستخدام مستند XML.

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

حماية ملف الرخصة الخاص بك

لحماية ملف رخصة Doconut (.lic) الخاص بك، من الضروري اتباع أفضل ممارسات أمان الملفات. احفظ ملف الرخصة في دليل آمن مع وصول محدود، مع ضمان أن المستخدمين أو الخدمات المصرح لهم فقط يمكنهم قراءته.