Sử dụng giấy phép Doconut của bạn

Hướng dẫn cài đặt và kích hoạt giấy phép của bạn.

Để tìm hiểu cách sử dụng giấy phép Doconut, hãy làm theo các hướng dẫn dưới đây cho các nền tảng .NET khác nhau.

Cài đặt giấy phép Doconut

.NET Framework

Phát hiện giấy phép tự động

Doconut có thể tự động phát hiện giấy phép nếu chúng được đặt trong thư mục bin của dự án.

Thêm giấy phép mặc định thủ công

Nếu bạn muốn thêm giấy phép theo cách thủ công, các tùy chọn sau có sẵn:

Thêm giấy phép bằng đường dẫn tệp

Phương pháp này sử dụng hàm quá tải Viewer.DoconutLicense(string licencePath) để thêm giấy phép bằng cách chỉ định đường dẫn tới tệp giấy phép.

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

Thêm giấy phép bằng luồng

Phương pháp này sử dụng hàm quá tải Viewer.DoconutLicense(Stream licenseStream) để thêm giấy phép bằng một luồng.

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

Thêm giấy phép bằng tài liệu XML

Phương pháp này sử dụng hàm quá tải Viewer.DoconutLicense(XMLDocument licence) để thêm giấy phép bằng một tài liệu XML.

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

Thêm giấy phép plugin bằng đường dẫn tệp

Phương pháp này sử dụng hàm quá tải Viewer.SetLicensePlugin(string pathPluginLicence) để thêm giấy phép plugin bằng cách chỉ định đường dẫn tới tệp giấy phép plugin.

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

Thêm giấy phép plugin bằng luồng

Phương pháp này sử dụng hàm quá tải Viewer.SetLicensePlugin(Stream pluginLicence) để thêm giấy phép plugin bằng một luồng.

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

Thêm giấy phép plugin bằng tài liệu XML

Phương pháp này sử dụng hàm quá tải Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) để thêm giấy phép plugin bằng một tài liệu XML.

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

.NET Standard/Core and .NET 6 and higher

Phát hiện giấy phép tự động

Doconut có thể tự động phát hiện giấy phép nếu chúng được đặt trong thư mục wwwroot của dự án.

Để khởi tạo docViewer với phát hiện giấy phép tự động, hãy sử dụng dòng sau:

C#
var docViewer = new Viewer(_cache, _accessor);

Thêm giấy phép mặc định thủ công

Bạn có thể chỉ định thủ công đường dẫn tới một tệp giấy phép mặc định duy nhất khi khởi tạo trình xem.

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

Thêm giấy phép bằng luồng

Phương pháp này sử dụng hàm quá tải Viewer.DoconutLicense(Stream licenseStream) để thêm giấy phép bằng một luồng.

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

Thêm giấy phép bằng tài liệu XML

Phương pháp này sử dụng hàm quá tải Viewer.DoconutLicense(XMLDocument licence) để thêm giấy phép bằng một tài liệu XML.

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

Nhiều giấy phép plugin mặc định thủ công

Nếu bạn cần chỉ định nhiều giấy phép, bạn có thể cung cấp danh sách các đường dẫn tệp cho quá trình khởi tạo trình xem.

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

Thêm giấy phép plugin bằng luồng

Phương pháp này sử dụng hàm quá tải Viewer.SetLicensePlugin(Stream pluginLicence) để thêm giấy phép plugin bằng một luồng.

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

Thêm giấy phép plugin bằng tài liệu XML

Phương pháp này sử dụng hàm quá tải Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) để thêm giấy phép plugin bằng một tài liệu XML.

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

Bảo vệ tệp giấy phép của bạn

Để bảo vệ tệp giấy phép Doconut (.lic) của bạn, điều quan trọng là tuân thủ các thực hành tốt nhất về bảo mật tệp. Lưu tệp giấy phép trong một thư mục an toàn với quyền truy cập hạn chế, đảm bảo chỉ người dùng hoặc dịch vụ được ủy quyền mới có thể đọc được.