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 manualmente

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 por flujo (Stream)

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

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

Añadir licencia por documento XML

Este método utiliza la sobrecarga Viewer.DoconutLicense(XMLDocument licence) para añadir una licencia usando 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 por flujo (Stream)

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

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

Añadir licencia de complemento por documento XML

Este método utiliza la sobrecarga Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) para añadir una licencia de complemento usando 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 el docViewer con detección automática de licencia, use la siguiente línea:

var docViewer = new Viewer(_cache, _accessor);

Añadir licencia predeterminada manualmente

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

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

Añadir licencia por flujo (Stream)

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

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

Añadir licencia por documento XML

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

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

Licencias predeterminadas manuales múltiples de complementos

Si necesita especificar múltiples 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 por flujo (Stream)

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

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

Añadir licencia de complemento por documento XML

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

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

Protección de 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 usuarios o servicios autorizados puedan leerlo.