1. IronXL
  2. Comece agora
  3. Utilizando chaves de licença

Usando as Chaves de Licença do IronXL

Curtis Chau
Curtis Chau
Atualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Como obter uma chave de licença

Adicionar uma chave de licença IronXL permite que você implemente seu projeto ao vivo sem restrições ou marcas d'água.

Você pode comprar uma chave de licença ou se inscrever para uma chave de teste gratuita de 30 dias aqui.

Passo 1: Baixe a Última Versão do IronXL

A primeira coisa que precisamos fazer é instalar a biblioteca IronXl.Excel, adicionando funcionalidade Excel ao framework .NET.

Instalar com o Pacote NuGet

  1. No Visual Studio, clique com o botão direito no projeto e selecione "Gerenciar Pacotes NuGet ..."
  2. Pesquise pelo pacote IronXl.Excel e instale

Ou

  1. Entre no Console do Gerenciador de Pacotes

  2. Digite:

    Install-Package IronXl.Excel

Veja o pacote no site do NuGet aqui.

Instalação por Download Direto do DLL

Download the IronXL [.NET Excel DLL]() and manually install it into Visual Studio.

Passo 2: Aplique sua chave de licença

Defina a chave de licença dentro do seu código

Adicione este código na inicialização da sua aplicação, antes que o IronXL seja usado.

// Set the IronXL license key for your project
IronXl.License.LicenseKey = "IRONXL-MYLICENSE-KEY-1EF01";
// Set the IronXL license key for your project
IronXl.License.LicenseKey = "IRONXL-MYLICENSE-KEY-1EF01";
$vbLabelText   $csharpLabel

Defina sua chave usando o Web.Config ou o App.Config em aplicativos .NET Framework.

Para aplicar uma chave globalmente à sua aplicação usando Web.Config ou App.Config, adicione a seguinte chave ao seu arquivo de configuração em appSettings.

<configuration>
  ...
  <appSettings>

    <add key="IronXl.LicenseKey" value="IRONXL-MYLICENSE-KEY-1EF01"/>
  </appSettings>
  ...
</configuration>
<configuration>
  ...
  <appSettings>

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

Existe um problema conhecido de licenciamento entre a versão 2023.4.13 - 2024.3.20 do IronXL no projeto:

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

A chave armazenada em um arquivo Web.config NÃO está sendo captada e usada pelo produto. Visite o artigo de solução de problemas 'Configuração da Chave de Licença no Web.config' para saber mais.

Certifique-se de que IronXl.License.IsLicensed retorna true para verificar.

Defina sua chave usando um arquivo appsettings.json do .NET Core.

Para aplicar uma chave globalmente à sua aplicação .NET Core :

  • Adicione um arquivo JSON ao seu projeto chamado appsettings.json no diretório raiz do seu projeto
  • Adicione uma chave 'IronXl.LicenseKey' ao seu arquivo de configuração JSON. O valor deve ser a sua chave de licença.
  • Certifique-se de que as propriedades do arquivo incluam Copiar Para o Diretório de Saída: Copiar sempre
  • Certifique-se de que IronXl.License.IsLicensed retorna true para verificar.

Arquivo: appsettings.json

{
  "IronXl.LicenseKey": "IRONXL-MYLICENSE-KEY-1EF01"
}

Passo 3: Teste sua chave

Teste se sua chave foi instalada corretamente.

// Check if a given license key string is valid.
bool result = IronXl.License.IsValidLicense("IRONXL-MYLICENSE-KEY-1EF01");

// Check if IronXL is licensed successfully
bool is_licensed = IronXl.License.IsLicensed;
// Check if a given license key string is valid.
bool result = IronXl.License.IsValidLicense("IRONXL-MYLICENSE-KEY-1EF01");

// Check if IronXL is licensed successfully
bool is_licensed = IronXl.License.IsLicensed;
$vbLabelText   $csharpLabel

Nota: Após adicionar uma licença, lembre-se sempre de limpar e republicar sua aplicação para evitar possíveis erros na implantação.

Passo 4: Comece seu projeto

Siga nosso tutorial sobre como Começar com IronXL.

Questões?

Se tiver alguma dúvida, entre em contato com support@ironsoftware.com.

Perguntas frequentes

Como faço para obter uma chave de licença para o meu projeto?

Você pode adquirir uma chave de licença comprando-a no site da IronXL ou inscrevendo-se para um teste gratuito de 30 dias.

Quais são os passos para instalar o IronXL usando o Gerenciador de Pacotes NuGet?

Para instalar o IronXL usando o Gerenciador de Pacotes NuGet, abra o Visual Studio, clique com o botão direito do mouse no seu projeto, selecione "Gerenciar Pacotes NuGet...", procure por IronXl.Excel e instale-o. Como alternativa, você pode usar o Console do Gerenciador de Pacotes para digitar Install-Package IronXl.Excel .

Como posso instalar o IronXL manualmente usando uma DLL?

Você pode instalar o IronXL manualmente baixando a DLL do .NET Excel do site da IronXL e adicionando-a ao seu projeto do Visual Studio.

Como faço para aplicar minha chave de licença no meu código de aplicativo?

Adicione a chave de licença ao código de inicialização do seu aplicativo usando: IronXl.License.LicenseKey = "YOUR-LICENSE-KEY" .

Como posso definir minha chave de licença no arquivo Web.Config para um aplicativo .NET Framework?

Você pode definir sua chave de licença no arquivo Web.Config adicionando o seguinte na seção appSettings: .

Há algum problema conhecido com o licenciamento em determinadas versões do IronXL?

Sim, existe um problema conhecido com as versões do IronXL de 2023.4.13 a 2024.3.20 em projetos ASP.NET e versões do .NET Framework 4.6.2 e superiores, onde a chave armazenada no Web.config pode não ser reconhecida.

Como faço para aplicar minha chave de licença usando o arquivo appsettings.json em uma aplicação .NET Core?

Em sua aplicação .NET Core, adicione um arquivo JSON chamado appsettings.json, inclua uma entrada 'IronXl.LicenseKey' com sua chave de licença e defina a propriedade do arquivo como 'Copiar para o diretório de saída: Copiar sempre'.

Como posso verificar se minha chave de licença do IronXL foi aplicada corretamente?

Para verificar sua chave de licença, use IronXl.License.IsValidLicense("YOUR-LICENSE-KEY") para verificar sua validade e certifique-se de que IronXl.License.IsLicensed retorne verdadeiro.

Quais são os passos a seguir após adicionar uma chave de licença?

Após adicionar uma chave de licença, é importante limpar e republicar sua aplicação para evitar problemas de implantação.

Onde posso encontrar ajuda ou suporte adicional?

Para obter ajuda ou suporte adicionais, você pode entrar em contato com a equipe de suporte da Iron Software pelo e-mail support@ironsoftware.com.

O licenciamento do IronXL é totalmente compatível com projetos e plataformas .NET 10?

Sim. Os produtos da IronXL, incluindo o licenciamento via código, Web.Config ou appsettings.json, são totalmente compatíveis com o .NET 10 (além das versões .NET 9, 8, 7, 6 e .NET Core/Standard/Framework) sem necessidade de configuração especial. Para aplicar uma chave de licença no .NET 10, utilize os mesmos métodos descritos na documentação oficial: defina IronXl.License.LicenseKey no código de inicialização ou utilize um arquivo de configuração como o appsettings.json com "IronXl.LicenseKey": "YOUR-KEY" e certifique-se de que o arquivo seja copiado para o diretório de saída. Isso está de acordo com as declarações de compatibilidade da IronXL. ([ironsoftware.com](https://ironsoftware.com/csharp/excel/?utm_source=openai))

Curtis Chau
Curtis Chau
  Converse agora mesmo com a equipe de engenharia.
Redator Técnico

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

Leia mais

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/ready_to_started_202509.php
Line: 12
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 489
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Getstarted.php
Line: 25
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/ready_to_started_202509.php
Line: 19
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 489
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Getstarted.php
Line: 25
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

Pronto para começar?
Nuget Downloads 1,890,100 | Versão: 2026.3 acaba de ser lançado

Nesta página

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/still_scrolling_202512.php
Line: 17
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 71
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/get-started/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Getstarted.php
Line: 25
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/still_scrolling_202512.php
Line: 24
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 71
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/get-started/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Getstarted.php
Line: 25
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronXl.Excel
executar um exemplo Veja seus dados se transformarem em uma planilha.