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. Thực hiện 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

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.

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.

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.

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.

var pluginLicensePath = "path/to/your/plugin-license.lic";
new Viewer().DoconutLicense(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.

using var pluginLicenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var viewer = new Doconut.Viewer();
viewer.DoconutLicense(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.

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

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

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, sử dụng dòng sau:

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

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.

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

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.

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

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.

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

var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
var license = new DoconutLicense(); // điền các thuộc tính từ xmlDoc khi cần

Giấy phép Plugin Mặc định Nhiều (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.

// Giấy phép được cấu hình qua dependency injection; không cần constructor rõ ràng.
var viewer = /* đối tượng Viewer được DI‑resolved */ null;

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.

using var licenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var config = new BaseConfig(); // luồng license được BaseConfig tiêu thụ nội bộ

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.

using System.Xml;
var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
// Việc tải License không còn cần thiết trong Doconut.NETStandard 26.9.0

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.