Definindo a chave de licença no arquivo Web.config.

Curtis Chau
Curtis Chau
Updated: 29 de junho de 2026

This problem has been solved since IronOCR version 2024.3.4.

Exception: Unhandled exception. IronSoftware.Exceptions.LicensingException: IronOCR must be licensed for development.
Text

Para versões mais antigas do IronOCR, especificamente aquelas entre as versões 2023.4.13 e 2024.3.4, há um problema conhecido de licenciamento em:

  • Projetos ASP.NET
  • Versão do .NET Framework >= 4.6.2

A chave armazenada em um arquivo Web.config NÃO será captada e usada pelo produto.

Solução alternativa

Para resolver esse problema, recomenda-se recuperar a chave de licença do arquivo Web.config usando ConfigurationManager no código, e então aplicá-la à propriedade License.LicenseKey.

Exemplo:

<configuration>
  ...
  <appSettings>
    <add key="IronOcr.LicenseKey" value="IRONOCR-MYLICENSE-KEY-1EF01"/>
  </appSettings>
  ...
</configuration>
XML

Com o arquivo XML fornecido acima, podemos usar ConfigurationManager para recuperar o valor da chave de licença e passá-la para a propriedade IronOcr.License.LicenseKey.

using System.Configuration;

// Retrieve the license key from the Web.config's appSettings
string licenseKey = ConfigurationManager.AppSettings["IronOcr.LicenseKey"];

// Apply the license key to IronOcr to avoid licensing exceptions
IronOcr.License.LicenseKey = licenseKey;

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

Leia mais

Pronto para começar?

Nuget Downloads 6,357,159Versão:2026.11recém-lançado