การใช้ใบอนุญาต Doconut ของคุณ

คำแนะนำสำหรับการติดตั้งและเปิดใช้งานใบอนุญาตของคุณ.

เพื่อค้นหาวิธีการใช้ใบอนุญาต Doconut ให้ทำตามคำแนะนำด้านล่างสำหรับแพลตฟอร์ม .NET ต่าง ๆ.

การติดตั้งใบอนุญาต Doconut

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

เพิ่มใบอนุญาตโดยสตรีม

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

เพิ่มใบอนุญาตโดยเอกสาร 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);

เพิ่มใบอนุญาตปลั๊กอินโดยสตรีม

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

เพิ่มใบอนุญาตปลั๊กอินโดยเอกสาร XML

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

การปกป้องไฟล์ใบอนุญาตของคุณ

เพื่อปกป้องไฟล์ใบอนุญาต Doconut ของคุณ (.lic) จำเป็นต้องปฏิบัติตามแนวทางปฏิบัติที่ดีที่สุดสำหรับความปลอดภัยของไฟล์ เก็บไฟล์ใบอนุญาตในไดเรกทอรีที่ปลอดภัยพร้อมการเข้าถึงที่จำกัด เพื่อให้แน่ใจว่าเฉพาะผู้ใช้หรือบริการที่ได้รับอนุญาตเท่านั้นที่สามารถอ่านได้.