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

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

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

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

.NET Framework

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

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

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

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

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

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

csharp

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

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

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

csharp

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

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

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

csharp

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

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

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

csharp

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

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

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

csharp

using var pluginLicenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var viewer = new Doconut.Viewer();
viewer.DoconutLicense(pluginLicenseStream);

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

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

csharp

var viewer = new Viewer();
viewer.DoconutLicense("path/to/your/plugin-license.xml");

.NET Standard/Core และ .NET 6 หรือสูงกว่า

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

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

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

csharp

using Microsoft.Extensions.DependencyInjection;
var docViewer = app.Services.GetRequiredService<Doconut.Viewer>();

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

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

csharp

using System.IO;
var licenseFilePath = Path.Combine(path, "path/to/your/license");
var token = await viewer.OpenDocumentAsync(licenseFilePath, new BaseConfig(), new DocOptions(), ct);

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

csharp

using (var licenseStream = new FileStream("path/to/your/license", FileMode.Open))
{
    var license = new DoconutLicense
    {
        DocBytes = new BinaryReader(licenseStream).ReadBytes((int)licenseStream.Length)
    };
}

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

csharp

using System.Xml;
using Doconut.Infrastructure.Licensing;

var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
var license = new DoconutLicense(); // เติมค่า properties จาก xmlDoc ตามต้องการ

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

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

csharp

// Licences ถูกกำหนดค่าโดย dependency injection; ไม่จำเป็นต้องมี constructor อย่างชัดเจน
var viewer = /* อินสแตนซ์ Viewer ที่ DI‑resolved */ null;

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

csharp

using var licenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var config = new BaseConfig(); // สตรีม license ถูกใช้ภายในโดย BaseConfig

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

csharp

using System.Xml;
var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
// การโหลด License ไม่จำเป็นต้องทำอีกต่อไปใน Doconut.NETStandard 26.9.0

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

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