Usando sua licença Doconut

Para descobrir como usar uma licença Doconut, siga as instruções abaixo para diferentes plataformas .NET.

Instalação da Licença Doconut

Nesta seção, você aprenderá como instalar e ativar sua licença Doconut em vários ambientes, incluindo .NET Framework, .NET Standard/Core e .NET 6. Siga os passos fornecidos para garantir a integração perfeita da sua licença ao seu projeto:

.NET Framework

Detecção automática de licença

Doconut pode detectar licenças automaticamente se elas forem colocadas na pasta bin do projeto.

Adicionar licença padrão manual

Se você preferir adicionar a licença manualmente, as opções a seguir estão disponíveis:

Adicionar licença por caminho de arquivo

Este método usa a sobrecarga Viewer.DoconutLicense(string licencePath) para adicionar uma licença especificando o caminho para o arquivo de licença.

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

Adicionar licença por stream

Este método usa a sobrecarga Viewer.DoconutLicense(Stream licenseStream) para adicionar uma licença usando um stream.

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

Adicionar licença por documento XML

Este método usa a sobrecarga Viewer.DoconutLicense(XMLDocument licence) para adicionar uma licença usando um documento XML.

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

Adicionar licença de plugin por caminho de arquivo

Este método usa a sobrecarga Viewer.SetLicensePlugin(string pathPluginLicence) para adicionar uma licença de plugin especificando o caminho para o arquivo de licença do plugin.

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

Adicionar licença de plugin por stream

Este método usa a sobrecarga Viewer.SetLicensePlugin(Stream pluginLicence) para adicionar uma licença de plugin usando um stream.

using var pluginLicenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var viewer = new Doconut.Viewer();
viewer.DoconutLicense(pluginLicenseStream);

Adicionar licença de plugin por documento XML

Este método usa a sobrecarga Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) para adicionar uma licença de plugin usando um documento XML.

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

.NET Standard/Core e .NET 6 e superiores

Detecção automática de licença

Doconut pode detectar licenças automaticamente se elas forem colocadas na pasta wwwroot do projeto.

Para inicializar o docViewer com detecção automática de licença, use a linha a seguir:

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

Adicionar licença padrão manual

Você pode especificar manualmente o caminho para um único arquivo de licença padrão ao inicializar o visualizador.

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

Adicionar licença por stream

Este método usa a sobrecarga Viewer.DoconutLicense(Stream licenseStream) para adicionar uma licença usando um stream.

using (var licenseStream = new FileStream("path/to/your/license", FileMode.Open))
{
    var license = new DoconutLicense
    {
        DocBytes = new BinaryReader(licenseStream).ReadBytes((int)licenseStream.Length)
    };
}

Adicionar licença por documento XML

Este método usa a sobrecarga Viewer.DoconutLicense(XMLDocument licence) para adicionar uma licença usando um documento XML.

using System.Xml;
using Doconut.Infrastructure.Licensing;

var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
var license = new DoconutLicense(); // preencher propriedades a partir de xmlDoc conforme necessário

Licenças padrão múltiplas de plugin manual

Se precisar especificar várias licenças, você pode fornecer uma lista de caminhos de arquivos na inicialização do visualizador.

// Licenças são configuradas via injeção de dependência; nenhum construtor explícito é necessário.
var viewer = /* Instância de Viewer resolvida por DI */ null;

Adicionar licença de plugin por stream

Este método usa a sobrecarga Viewer.SetLicensePlugin(Stream pluginLicence) para adicionar uma licença de plugin usando um stream.

using var licenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var config = new BaseConfig(); // o fluxo de licença é consumido internamente por BaseConfig

Adicionar licença de plugin por documento XML

Este método usa a sobrecarga Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) para adicionar uma licença de plugin usando um documento XML.

using System.Xml;
var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
// Carregamento de licença não é mais necessário em Doconut.NETStandard 26.9.0

Protegendo seu arquivo de licença

Para proteger seu arquivo de licença Doconut (.lic), é essencial seguir as melhores práticas de segurança de arquivos. Armazene o arquivo de licença em um diretório seguro com acesso restrito, garantindo que apenas usuários ou serviços autorizados possam lê‑lo.