Usando sua Licença Doconut

Instruções para instalar e ativar sua licença.

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

Instalação de Licença Doconut

.NET Framework

Detecção Automática de Licença

Doconut pode detectar automaticamente licenças se elas estiverem 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.

C#
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.

C#
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.

C#
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.

C#
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.

C#
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.

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

.NET Standard/Core e .NET 6 ou superior

Detecção Automática de Licença

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

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

C#
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.

C#
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.

C#
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.

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

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

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

C#
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.

C#
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.

C#
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.