Utilizzare la tua licenza Doconut

Per scoprire come utilizzare una licenza Doconut, segui le istruzioni riportate di seguito per le diverse piattaforme .NET.

Installazione della licenza Doconut

In questa sezione imparerai come installare e attivare la tua licenza Doconut in vari ambienti, inclusi .NET Framework, .NET Standard/Core e .NET 6. Segui i passaggi forniti per garantire un'integrazione fluida della tua licenza nel progetto:

.NET Framework

Rilevamento automatico della licenza

Doconut può rilevare automaticamente le licenze se vengono collocate nella cartella bin del progetto.

Aggiungi licenza predefinita manuale

Se preferisci aggiungere la licenza manualmente, sono disponibili le seguenti opzioni:

Aggiungi licenza tramite percorso file

Questo metodo utilizza il sovraccarico Viewer.DoconutLicense(string licencePath) per aggiungere una licenza specificando il percorso del file di licenza.

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

Aggiungi licenza tramite stream

Questo metodo utilizza il sovraccarico Viewer.DoconutLicense(Stream licenseStream) per aggiungere una licenza usando uno stream.

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

Aggiungi licenza tramite documento XML

Questo metodo utilizza il sovraccarico Viewer.DoconutLicense(XMLDocument licence) per aggiungere una licenza usando un documento XML.

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

Aggiungi licenza plugin tramite percorso file

Questo metodo utilizza il sovraccarico Viewer.SetLicensePlugin(string pathPluginLicence) per aggiungere una licenza plugin specificando il percorso del file di licenza del plugin.

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

Aggiungi licenza plugin tramite stream

Questo metodo utilizza il sovraccarico Viewer.SetLicensePlugin(Stream pluginLicence) per aggiungere una licenza plugin usando uno stream.

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

Aggiungi licenza plugin tramite documento XML

Questo metodo utilizza il sovraccarico Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) per aggiungere una licenza plugin usando un documento XML.

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

.NET Standard/Core e .NET 6 e versioni successive

Rilevamento automatico della licenza

Doconut può rilevare automaticamente le licenze se vengono collocate nella cartella wwwroot del progetto.

Per inizializzare docViewer con il rilevamento automatico della licenza, utilizza la riga seguente:

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

Aggiungi licenza predefinita manuale

Puoi specificare manualmente il percorso di un singolo file di licenza predefinita durante l'inizializzazione del visualizzatore.

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

Aggiungi licenza tramite stream

Questo metodo utilizza il sovraccarico Viewer.DoconutLicense(Stream licenseStream) per aggiungere una licenza usando uno stream.

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

Aggiungi licenza tramite documento XML

Questo metodo utilizza il sovraccarico Viewer.DoconutLicense(XMLDocument licence) per aggiungere una licenza usando un documento XML.

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

var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
var license = new DoconutLicense(); // popola le proprietà da xmlDoc secondo necessità

Licenze plugin predefinite multiple manuali

Se è necessario specificare più licenze, puoi fornire un elenco di percorsi file durante l'inizializzazione del visualizzatore.

// Le licenze sono configurate tramite iniezione delle dipendenze; non è necessario un costruttore esplicito.
var viewer = /* istanza Viewer risolta da DI‑resolved */ null;

Aggiungi licenza plugin tramite stream

Questo metodo utilizza il sovraccarico Viewer.SetLicensePlugin(Stream pluginLicence) per aggiungere una licenza plugin usando uno stream.

using var licenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var config = new BaseConfig(); // il flusso di licenza è consumato internamente da BaseConfig

Aggiungi licenza plugin tramite documento XML

Questo metodo utilizza il sovraccarico Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) per aggiungere una licenza plugin usando un documento XML.

using System.Xml;
var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
// Il caricamento della licenza non è più necessario in Doconut.NETStandard 26.9.0

Protezione del file di licenza

Per proteggere il tuo file di licenza Doconut (.lic), è fondamentale seguire le migliori pratiche di sicurezza dei file. Conserva il file di licenza in una directory sicura con accesso limitato, assicurandoti che solo utenti o servizi autorizzati possano leggerlo.