Configuração da licença do IronZip no arquivo web.config.

Curtis Chau
Curtis Chau
Updated: 22 de abril de 2026

Sabe-se que este problema afeta as versões do IronZip lançadas antes da 2024.3.3.

Observe: As notas de versão publicadas dessa versão não mencionam especificamente uma correção de licenciamento para Web.config/appSettings, portanto, se você estiver na 2024.3.3 ou posterior e ainda encontrar essa exceção, a solução alternativa abaixo ainda se aplica.
Exception: Unhandled exception. IronSoftware.Exceptions.LicensingException: IronZip must be licensed for development.
SHELL

Para versões antigas do IronZIP, especificamente aquelas lançadas antes da versão 2024.3.3, há um problema de licenciamento conhecido 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 este problema, é recomendável recuperar a chave de licença do arquivo Web.config usando ConfigurationManager no código e, em seguida, aplicá-la à propriedade License.LicenseKey.

Exemplo:

<configuration>
  ...
  <appSettings>
    <add key="IronZip.LicenseKey" value="IRONZIP.MYLICENSE.KEY.1EF01"/>
  </appSettings>
  ...
</configuration>
XML

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

using System;
using System.Configuration;

class Program
{
    static void Main()
    {
        // Retrieve the license key from the web.config appSettings
        string licenseKey = ConfigurationManager.AppSettings["IronZip.LicenseKey"];

        // Apply the license key to IronZip
        IronZip.License.LicenseKey = licenseKey;

        // Verify that the license key is set properly
        Console.WriteLine("License key applied successfully.");
    }
}
  • A diretiva using System.Configuration; permite o acesso a arquivos de configuração, como Web.config.
  • ConfigurationManager.AppSettings["IronZip.LicenseKey"] recupera a chave de licença armazenada na seção appSettings de Web.config.
  • IronZip.License.LicenseKey = licenseKey; atribui a chave recuperada à biblioteca IronZIP para evitar exceções de licenciamento.
  • A instrução Console.WriteLine() fornece feedback ao desenvolvedor de que o processo de aplicação da chave de licença foi concluído com sucesso.

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 24,981Versão:2026.11recém-lançado