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 licencias

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

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 por 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";
new Viewer().DoconutLicense(pluginLicensePath);

Añadir licencia de complemento por 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);
var viewer = new Doconut.Viewer();
viewer.DoconutLicense(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 mediante un documento XML.

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

.NET Standard/Core y .NET 6 y superiores

Detección automática de licencias

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 licencias, use la siguiente línea:

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

Añadir licencia predeterminada manualmente

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

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

Añadir licencia por 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))
{
    var license = new DoconutLicense
    {
        DocBytes = new BinaryReader(licenseStream).ReadBytes((int)licenseStream.Length)
    };
}

Añadir licencia por documento XML

Este método utiliza la sobrecarga Viewer.DoconutLicense(XMLDocument licence) para añadir una licencia mediante 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(); // poblar propiedades desde xmlDoc según sea necesario

Licencias de complemento múltiples predeterminadas manuales

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

// Las licencias se configuran mediante inyección de dependencias; no se requiere un constructor explícito.
var viewer = /* Instancia de Viewer resuelta por DI */ null;

Añadir licencia de complemento por flujo

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

using var licenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var config = new BaseConfig(); // el flujo de licencia se consume internamente por BaseConfig

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 mediante un documento XML.

using System.Xml;
var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
// La carga de licencias ya no es necesaria en Doconut.NETStandard 26.9.0

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.