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 licenza nel tuo 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";
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 vengono collocate nella cartella wwwroot del progetto.

Per inizializzare il 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 di 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 multiple predefinite manuali

Se è necessario specificare più licenze, puoi fornire un elenco di percorsi file durante l'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 salvaguardare il file della licenza Doconut (.lic), è fondamentale seguire le migliori pratiche per la sicurezza dei file. Conserva il file della licenza in una directory sicura con accesso limitato, assicurandoti che solo utenti o servizi autorizzati possano leggerlo.