Usando su licencia Doconut

Para descubrir cómo usar una licencia Doconut, siga las instrucciones a continuación para diferentes plataformas .NET.

Instalación de la licencia Doconut

En esta sección, aprenderá cómo instalar y activar su licencia Doconut en varios entornos, incluidos .NET Framework, .NET Standard/Core y .NET 6. Siga los pasos proporcionados para garantizar una integración sin problemas de su licencia en su proyecto:

.NET Framework

Detección automática de licencia

Doconut puede detectar automáticamente licencias si se colocan dentro de la carpeta bin del proyecto.

Añadir licencia predeterminada manual

Si prefiere añadir la licencia manualmente, están disponibles las siguientes opciones:

Añadir licencia por ruta de archivo

Este método utiliza la sobrecarga Viewer.DoconutLicense(string licencePath) para añadir una licencia especificando la ruta al archivo de licencia.

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

Añadir licencia mediante flujo

Este método utiliza la sobrecarga Viewer.DoconutLicense(Stream licenseStream) para añadir una licencia mediante un flujo.

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

Añadir licencia mediante documento XML

Este método utiliza la sobrecarga Viewer.DoconutLicense(XMLDocument licence) para añadir una licencia mediante un documento XML.

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

Añadir licencia de complemento por ruta de archivo

Este método utiliza la sobrecarga Viewer.SetLicensePlugin(string pathPluginLicence) para añadir una licencia de complemento especificando la ruta al archivo de licencia del complemento.

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

Añadir licencia de complemento mediante flujo

Este método utiliza la sobrecarga Viewer.SetLicensePlugin(Stream pluginLicence) para añadir una licencia de complemento mediante un flujo.

using (var pluginLicenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open))
{
    Viewer.SetLicensePlugin(pluginLicenseStream);
}

Añadir licencia de complemento mediante documento XML

Este método utiliza la sobrecarga Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) para añadir una licencia de complemento mediante un documento XML.

var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
Viewer.SetLicensePlugin(pluginXmlDoc);

.NET Standard/Core y .NET 6 y superiores

Detección automática de licencia

Doconut puede detectar automáticamente licencias si se colocan dentro de la carpeta wwwroot del proyecto.

Para inicializar docViewer con detección automática de licencia, use la siguiente línea:

var docViewer = new Viewer(_cache, _accessor);

Añadir licencia predeterminada manual

Puede especificar manualmente la ruta a un único archivo de licencia predeterminada al inicializar el visor.

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

Añadir licencia mediante flujo

Este método utiliza la sobrecarga Viewer.DoconutLicense(Stream licenseStream) para añadir una licencia mediante un flujo.

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

Añadir licencia mediante documento XML

Este método utiliza la sobrecarga Viewer.DoconutLicense(XMLDocument licence) para añadir una licencia mediante un documento XML.

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

Licencias de complementos múltiples predeterminadas manuales

Si necesita especificar varias licencias, puede proporcionar una lista de rutas de archivo a la inicialización del visor.

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

Añadir licencia de complemento mediante flujo

Este método utiliza la sobrecarga Viewer.SetLicensePlugin(Stream pluginLicence) para añadir una licencia de complemento mediante un flujo.

using (var pluginLicenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open))
{
    Viewer.SetLicensePlugin(pluginLicenseStream);
}

Añadir licencia de complemento mediante documento XML

Este método utiliza la sobrecarga Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) para añadir una licencia de complemento mediante un documento XML.

var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
Viewer.SetLicensePlugin(pluginXmlDoc);

Protegiendo su archivo de licencia

Para proteger su archivo de licencia Doconut (.lic), es esencial seguir las mejores prácticas de seguridad de archivos. Guarde el archivo de licencia en un directorio seguro con acceso restringido, asegurándose de que solo los usuarios o servicios autorizados puedan leerlo.