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

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

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

ในส่วนนี้คุณจะได้เรียนรู้วิธีการติดตั้งและเปิดใช้งานใบอนุญาต Doconut ของคุณในสภาพแวดล้อมต่าง ๆ รวมถึง .NET Framework, .NET Standard/Core, และ .NET 6 ให้ทำตามขั้นตอนที่ให้ไว้เพื่อให้การรวมใบอนุญาตเข้ากับโครงการของคุณเป็นไปอย่างราบรื่น

.NET Framework

การตรวจจับใบอนุญาตอัตโนมัติ

Doconut สามารถตรวจจับใบอนุญาตโดยอัตโนมัติได้หากวางไว้ในโฟลเดอร์ bin ของโครงการ

เพิ่มใบอนุญาตเริ่มต้นแบบแมนนวล

หากคุณต้องการเพิ่มใบอนุญาตด้วยตนเอง ตัวเลือกต่อไปนี้พร้อมให้ใช้:

เพิ่มใบอนุญาตโดยระบุเส้นทางไฟล์

วิธีนี้ใช้ฟังก์ชัน Viewer.DoconutLicense(string licencePath) overload เพื่อเพิ่มใบอนุญาตโดยระบุเส้นทางไปยังไฟล์ใบอนุญาต

csharp

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

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

วิธีนี้ใช้ฟังก์ชัน Viewer.DoconutLicense(Stream licenseStream) overload เพื่อเพิ่มใบอนุญาตโดยใช้สตรีม

csharp

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

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

วิธีนี้ใช้ฟังก์ชัน Viewer.DoconutLicense(XMLDocument licence) overload เพื่อเพิ่มใบอนุญาตโดยใช้เอกสาร XML

csharp

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

เพิ่มใบอนุญาตปลั๊กอินโดยระบุเส้นทางไฟล์

วิธีนี้ใช้ฟังก์ชัน Viewer.SetLicensePlugin(string pathPluginLicence) overload เพื่อเพิ่มใบอนุญาตปลั๊กอินโดยระบุเส้นทางไปยังไฟล์ใบอนุญาตปลั๊กอิน

csharp

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

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

วิธีนี้ใช้ฟังก์ชัน Viewer.SetLicensePlugin(Stream pluginLicence) overload เพื่อเพิ่มใบอนุญาตปลั๊กอินโดยใช้สตรีม

csharp

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

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

วิธีนี้ใช้ฟังก์ชัน Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) overload เพื่อเพิ่มใบอนุญาตปลั๊กอินโดยใช้เอกสาร XML

csharp

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

.NET Standard/Core และ .NET 6 ขึ้นไป

การตรวจจับใบอนุญาตอัตโนมัติ

Doconut สามารถตรวจจับใบอนุญาตโดยอัตโนมัติได้หากวางไว้ในโฟลเดอร์ wwwroot ของโครงการ

เพื่อเริ่มต้น docViewer ด้วยการตรวจจับใบอนุญาตอัตโนมัติ ให้ใช้บรรทัดต่อไปนี้

csharp

var docViewer = new Viewer(_cache, _accessor);

เพิ่มใบอนุญาตเริ่มต้นแบบแมนนวล

คุณสามารถระบุเส้นทางไปยังไฟล์ใบอนุญาตเริ่มต้นเดียวเมื่อเริ่มต้น viewer ได้ด้วยตนเอง

csharp

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

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

วิธีนี้ใช้ฟังก์ชัน Viewer.DoconutLicense(Stream licenseStream) overload เพื่อเพิ่มใบอนุญาตโดยใช้สตรีม

csharp

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

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

csharp

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

ใบอนุญาตปลั๊กอินเริ่มต้นหลายรายการแบบแมนนวล

หากคุณต้องการระบุหลายใบอนุญาต คุณสามารถส่งรายการของเส้นทางไฟล์ให้กับการเริ่มต้น viewer ได้

csharp

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

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

csharp

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

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

csharp

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

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

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