استخدام ترخيص 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";
Viewer.SetLicensePlugin(pluginLicensePath);

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

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

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

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

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

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

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

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

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

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

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

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

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) لإضافة ترخيص مكوّن إضافي باستخدام تدفق.

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

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

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

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

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

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