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 Manualmente

Se 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";
Viewer.SetLicensePlugin(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))
{
    Viewer.SetLicensePlugin(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 pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
Viewer.SetLicensePlugin(pluginXmlDoc);

.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:

var docViewer = new Viewer(_cache, _accessor);

Adicionar Licença Padrão Manualmente

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

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

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

Licenças Múltiplas de Plugin Padrão Manualmente

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

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

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))
{
    Viewer.SetLicensePlugin(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 pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
Viewer.SetLicensePlugin(pluginXmlDoc);

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.