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 senza problemi della tua licenza nel progetto:

.NET Framework

Rilevamento automatico della licenza

Doconut può rilevare automaticamente le licenze se sono 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 al file della 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 al file della licenza plugin.

var pluginLicensePath = "path/to/your/plugin-license.lic";
Viewer.SetLicensePlugin(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))
{
    Viewer.SetLicensePlugin(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 pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
Viewer.SetLicensePlugin(pluginXmlDoc);

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

Rilevamento automatico della licenza

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

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

var docViewer = new Viewer(_cache, _accessor);

Aggiungi licenza predefinita manuale

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

var licenseFilePath = Path.Combine(_hostingEnvironment.WebRootPath, "path/to/your/license");
var docViewer = new Viewer(_cache, _accessor, licenseFilePath);

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);

Licenze plugin predefinite multiple manuali

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

List<string> licenseFilePaths = new List<string>
{
    Path.Combine(_hostingEnvironment.WebRootPath, "Doconut.Viewer.lic"),
    Path.Combine(_hostingEnvironment.WebRootPath, "Doconut.Viewer.Annotation.lic"),
    Path.Combine(_hostingEnvironment.WebRootPath, "Doconut.Viewer.Search.lic")
};
var docViewer = new Viewer(_cache, _accessor, licenseFilePaths);

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))
{
    Viewer.SetLicensePlugin(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 pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
Viewer.SetLicensePlugin(pluginXmlDoc);

Proteggere il file della licenza

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