Sử dụng Giấy phép Doconut 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

Trong phần này, bạn sẽ học cách cài đặt và kích hoạt giấy phép Doconut của mình trên các môi trường khác nhau, bao gồm .NET Framework, .NET Standard/Core và .NET 6. Hãy làm theo các bước được cung cấp để đảm bảo việc tích hợp giấy phép của bạn vào dự án một cách liền mạch:

.NET Framework

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

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 một 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 nạp 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.

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 nạp Viewer.DoconutLicense(Stream licenseStream) để thêm giấy phép bằng một luồng.

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 nạp Viewer.DoconutLicense(XMLDocument licence) để thêm giấy phép bằng một tài liệu XML.

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 nạp 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.

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 nạp Viewer.SetLicensePlugin(Stream pluginLicence) để thêm giấy phép plugin bằng một luồng.

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 nạp Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) để thêm giấy phép plugin bằng một tài liệu XML.

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

.NET Standard/Core và .NET 6 trở lên

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

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 việc tự động phát hiện giấy phép, sử dụng dòng sau:

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.

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 nạp Viewer.DoconutLicense(Stream licenseStream) để thêm giấy phép bằng một luồng.

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 nạp Viewer.DoconutLicense(XMLDocument licence) để thêm giấy phép bằng một tài liệu XML.

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 việc khởi tạo trình xem.

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 nạp Viewer.SetLicensePlugin(Stream pluginLicence) để thêm giấy phép plugin bằng một luồng.

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 nạp Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) để thêm giấy phép plugin bằng một tài liệu XML.

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, cần 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ỉ những người dùng hoặc dịch vụ được ủy quyền mới có thể đọc được.