Använda din Doconut-licens

För att ta reda på hur du använder en Doconut-licens, följ instruktionerna nedan för olika .NET-plattformar.

Installation av Doconut-licens

I det här avsnittet kommer du att lära dig hur du installerar och aktiverar din Doconut-licens i olika miljöer, inklusive .NET Framework, .NET Standard/Core och .NET 6. Följ stegen för att säkerställa en smidig integration av din licens i ditt projekt:

.NET Framework

Automatisk licensdetektering

Doconut kan automatiskt upptäcka licenser om de placeras i projektets bin-mapp.

Lägg till manuell standardlicens

Om du föredrar att lägga till licensen manuellt, finns följande alternativ tillgängliga:

Lägg till licens via filsökväg

Denna metod använder Viewer.DoconutLicense(string licencePath)-överladdning för att lägga till en licens genom att ange sökvägen till licensfilen.

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

Lägg till licens via ström

Denna metod använder Viewer.DoconutLicense(Stream licenseStream)-överladdning för att lägga till en licens med en ström.

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

Lägg till licens via XML-dokument

Denna metod använder Viewer.DoconutLicense(XMLDocument licence)-överladdning för att lägga till en licens med ett XML-dokument.

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

Lägg till plugin-licens via filsökväg

Denna metod använder Viewer.SetLicensePlugin(string pathPluginLicence)-överladdning för att lägga till en plugin-licens genom att ange sökvägen till plugin-licensfilen.

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

Lägg till plugin-licens via ström

Denna metod använder Viewer.SetLicensePlugin(Stream pluginLicence)-överladdning för att lägga till en plugin-licens med en ström.

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

Lägg till plugin-licens via XML-dokument

Denna metod använder Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence)-överladdning för att lägga till en plugin-licens med ett XML-dokument.

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

.NET Standard/Core och .NET 6 och högre

Automatisk licensdetektering

Doconut kan automatiskt upptäcka licenser om de placeras i projektets wwwroot-mapp.

För att initiera docViewer med automatisk licensdetektering, använd följande rad:

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

Lägg till manuell standardlicens

Du kan manuellt ange sökvägen till en enda standardlicensfil när du initierar visaren.

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

Lägg till licens via ström

Denna metod använder Viewer.DoconutLicense(Stream licenseStream)-överladdning för att lägga till en licens med en ström.

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

Lägg till licens via XML-dokument

Denna metod använder Viewer.DoconutLicense(XMLDocument licence)-överladdning för att lägga till en licens med ett XML-dokument.

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

var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
var license = new DoconutLicense(); // populera egenskaper från xmlDoc vid behov

Manuell standard för flera plugin-licenser

Om du behöver ange flera licenser, kan du tillhandahålla en lista med filsökvägar till visarens initiering.

// Licenser konfigureras via beroendeinjektion; ingen explicit konstruktor krävs.
var viewer = /* DI‑resolved Viewer-instans */ null;

Lägg till plugin-licens via ström

Denna metod använder Viewer.SetLicensePlugin(Stream pluginLicence)-överladdning för att lägga till en plugin-licens med en ström.

using var licenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var config = new BaseConfig(); // licensströmmen konsumeras internt av BaseConfig

Lägg till plugin-licens via XML-dokument

Denna metod använder Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence)-överladdning för att lägga till en plugin-licens med ett XML-dokument.

using System.Xml;
var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
// Licensladdning krävs inte längre i Doconut.NETStandard 26.9.0

Skydda din licensfil

För att skydda din Doconut-licensfil (.lic) är det viktigt att följa bästa praxis för filsäkerhet. Förvara licensfilen i en säker katalog med begränsad åtkomst, så att endast behöriga användare eller tjänster kan läsa den.