Používání vaší licence Doconut

Abyste zjistili, jak používat licenci Doconut, postupujte podle níže uvedených instrukcí pro různé platformy .NET.

Instalace licence Doconut

V této sekci se naučíte, jak nainstalovat a aktivovat vaši licenci Doconut v různých prostředích, včetně .NET Framework, .NET Standard/Core a .NET 6. Postupujte podle uvedených kroků, abyste zajistili bezproblémovou integraci licence do vašeho projektu:

.NET Framework

Automatické rozpoznání licence

Doconut může automaticky rozpoznat licence, pokud jsou umístěny ve složce bin projektu.

Přidat výchozí licenci ručně

Pokud dáváte přednost přidání licence ručně, jsou k dispozici následující možnosti:

Přidat licenci podle cesty k souboru

Tato metoda používá overload Viewer.DoconutLicense(string licencePath) k přidání licence zadáním cesty k souboru licence.

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

Přidat licenci pomocí streamu

Tato metoda používá overload Viewer.DoconutLicense(Stream licenseStream) k přidání licence pomocí streamu.

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

Přidat licenci pomocí XML dokumentu

Tato metoda používá overload Viewer.DoconutLicense(XMLDocument licence) k přidání licence pomocí XML dokumentu.

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

Přidat licenci pluginu podle cesty k souboru

Tato metoda používá overload Viewer.SetLicensePlugin(string pathPluginLicence) k přidání licence pluginu zadáním cesty k souboru licence pluginu.

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

Přidat licenci pluginu pomocí streamu

Tato metoda používá overload Viewer.SetLicensePlugin(Stream pluginLicence) k přidání licence pluginu pomocí streamu.

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

Přidat licenci pluginu pomocí XML dokumentu

Tato metoda používá overload Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) k přidání licence pluginu pomocí XML dokumentu.

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

.NET Standard/Core a .NET 6 a vyšší

Automatické rozpoznání licence

Doconut může automaticky rozpoznat licence, pokud jsou umístěny ve složce wwwroot projektu.

Pro inicializaci docViewer s automatickým rozpoznáním licence použijte následující řádek:

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

Přidat výchozí licenci ručně

Můžete ručně zadat cestu k jedinému výchozímu souboru licence při inicializaci prohlížeče.

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

Přidat licenci pomocí streamu

Tato metoda používá overload Viewer.DoconutLicense(Stream licenseStream) k přidání licence pomocí streamu.

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

Přidat licenci pomocí XML dokumentu

Tato metoda používá overload Viewer.DoconutLicense(XMLDocument licence) k přidání licence pomocí XML dokumentu.

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

var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
var license = new DoconutLicense(); // naplňte vlastnosti z xmlDoc podle potřeby

Ruční výchozí více licencí pluginů

Pokud potřebujete zadat více licencí, můžete poskytnout seznam cest k souborům při inicializaci prohlížeče.

// Licence jsou konfigurovány pomocí injekce závislostí; není vyžadován explicitní konstruktor.
var viewer = /* DI‑resolved Viewer instance */ null;

Přidat licenci pluginu pomocí streamu

Tato metoda používá overload Viewer.SetLicensePlugin(Stream pluginLicence) k přidání licence pluginu pomocí streamu.

using var licenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var config = new BaseConfig(); // licenční stream je interně spotřebován třídou BaseConfig

Přidat licenci pluginu pomocí XML dokumentu

Tato metoda používá overload Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) k přidání licence pluginu pomocí XML dokumentu.

using System.Xml;
var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
// Načítání licence již není vyžadováno v Doconut.NETStandard 26.9.0

Ochrana souboru licence

Aby byla vaše licence Doconut (.lic) chráněna, je nezbytné dodržovat osvědčené postupy pro zabezpečení souborů. Uložte soubor licence do zabezpečeného adresáře s omezeným přístupem, aby jej mohli číst pouze oprávnění uživatelé nebo služby.