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