Używanie Twojej Licencji Doconut

Aby dowiedzieć się, jak używać licencji Doconut, postępuj zgodnie z poniższymi instrukcjami dla różnych platform .NET.

Instalacja Licencji Doconut

W tej sekcji dowiesz się, jak zainstalować i aktywować licencję Doconut w różnych środowiskach, w tym .NET Framework, .NET Standard/Core oraz .NET 6. Postępuj zgodnie z podanymi krokami, aby zapewnić płynne włączenie licencji do swojego projektu:

.NET Framework

Automatyczne Wykrywanie Licencji

Doconut może automatycznie wykrywać licencje, jeśli zostaną umieszczone w folderze bin projektu.

Dodaj Domyślną Licencję Ręcznie

Jeśli wolisz dodać licencję ręcznie, dostępne są następujące opcje:

Dodaj Licencję przez Ścieżkę Pliku

Ta metoda używa Viewer.DoconutLicense(string licencePath) przeciążenia, aby dodać licencję poprzez podanie ścieżki do pliku licencji.

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

Dodaj Licencję przez Strumień

Ta metoda używa Viewer.DoconutLicense(Stream licenseStream) przeciążenia, aby dodać licencję przy użyciu strumienia.

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

Dodaj Licencję przez Dokument XML

Ta metoda używa Viewer.DoconutLicense(XMLDocument licence) przeciążenia, aby dodać licencję przy użyciu dokumentu XML.

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

Dodaj Licencję Wtyczki przez Ścieżkę Pliku

Ta metoda używa Viewer.SetLicensePlugin(string pathPluginLicence) przeciążenia, aby dodać licencję wtyczki poprzez podanie ścieżki do pliku licencji wtyczki.

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

Dodaj Licencję Wtyczki przez Strumień

Ta metoda używa Viewer.SetLicensePlugin(Stream pluginLicence) przeciążenia, aby dodać licencję wtyczki przy użyciu strumienia.

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

Dodaj Licencję Wtyczki przez Dokument XML

Ta metoda używa Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) przeciążenia, aby dodać licencję wtyczki przy użyciu dokumentu XML.

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

.NET Standard/Core i .NET 6 oraz wyższe

Automatyczne Wykrywanie Licencji

Doconut może automatycznie wykrywać licencje, jeśli zostaną umieszczone w folderze wwwroot projektu.

Aby zainicjować docViewer z automatycznym wykrywaniem licencji, użyj następującej linii:

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

Dodaj Domyślną Licencję Ręcznie

Możesz ręcznie określić ścieżkę do pojedynczego domyślnego pliku licencji podczas inicjalizacji przeglądarki.

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

Dodaj Licencję przez Strumień

Ta metoda używa Viewer.DoconutLicense(Stream licenseStream) przeciążenia, aby dodać licencję przy użyciu strumienia.

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

Dodaj Licencję przez Dokument XML

Ta metoda używa Viewer.DoconutLicense(XMLDocument licence) przeciążenia, aby dodać licencję przy użyciu dokumentu XML.

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

var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
var license = new DoconutLicense(); // wypełnij właściwości z xmlDoc w razie potrzeby

Ręczne Domyślne Wielokrotne Licencje Wtyczek

Jeśli potrzebujesz określić wiele licencji, możesz podać listę ścieżek plików podczas inicjalizacji przeglądarki.

// Licencje są konfigurowane za pomocą wstrzykiwania zależności; nie jest wymagany jawny konstruktor.
var viewer = /* instancja Viewer rozwiązana przez DI */ null;

Dodaj Licencję Wtyczki przez Strumień

Ta metoda używa Viewer.SetLicensePlugin(Stream pluginLicence) przeciążenia, aby dodać licencję wtyczki przy użyciu strumienia.

using var licenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var config = new BaseConfig(); // strumień licencji jest konsumowany wewnętrznie przez BaseConfig

Dodaj Licencję Wtyczki przez Dokument XML

Ta metoda używa Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) przeciążenia, aby dodać licencję wtyczki przy użyciu dokumentu XML.

using System.Xml;
var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
// Ładowanie licencji nie jest już wymagane w Doconut.NETStandard 26.9.0

Ochrona Pliku Licencji

Aby zabezpieczyć swój plik licencji Doconut (.lic), należy stosować najlepsze praktyki w zakresie bezpieczeństwa plików. Przechowuj plik licencji w bezpiecznym katalogu z ograniczonym dostępem, zapewniając, że tylko upoważnieni użytkownicy lub usługi mogą go odczytać.