1. IronXL
  2. Comenzar
  3. Uso de claves de licencia

Using IronXL License Keys

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

How to Get a License Key

Adding an IronXL license key allows you to deploy your project live without restrictions or watermarks.

You can buy a license key or sign up for a free 30-day trial key here.

Step 1: Download the Latest Version of IronXL

Comience a usar IronXL en su proyecto hoy con una prueba gratuita.

Primer Paso:
green arrow pointer

The first thing we need to do is install the IronXL.Excel library, adding Excel functionality to the .NET framework.

Install with NuGet Package

  1. In Visual Studio, right-click on the project and select "Manage NuGet Packages ..."
  2. Search for the IronXL.Excel package and install

Or

  1. Enter the Package Manager Console

  2. Type:

    Install-Package IronXL.Excel

View the package on the NuGet site here.

DLL Direct Download Installation

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

Step 2: Apply Your License Key

Set the license key inside your code

Add this code to the startup of your application, before IronXL is used.

// 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";
' Set the IronXL license key for your project
IronXL.License.LicenseKey = "IRONXL-MYLICENSE-KEY-1EF01"
$vbLabelText   $csharpLabel

Set your key using Web.Config or App.Config in .NET Framework Applications

To apply a key globally to your application using Web.Config or App.Config, add the following key to your config file in appSettings.

<configuration>
  ...
  <appSettings>
    <!-- Define the IronXL license key -->
    <add key="IronXL.LicenseKey" value="IRONXL-MYLICENSE-KEY-1EF01"/>
  </appSettings>
  ...
</configuration>
<configuration>
  ...
  <appSettings>
    <!-- Define the IronXL license key -->
    <add key="IronXL.LicenseKey" value="IRONXL-MYLICENSE-KEY-1EF01"/>
  </appSettings>
  ...
</configuration>
XML

There is a known licensing issue between IronXL version 2023.4.13 - 2024.3.20 on project:

  • ASP.NET projects
  • .NET Framework version >= 4.6.2

The key stored in a Web.config file is NOT being picked up and used by the product. Visit the 'Setting License Key in Web.config' troubleshooting article to learn more.

Ensure that IronXL.License.IsLicensed returns true to verify.

Set your key using a .NET Core appsettings.json file

To apply a key globally to your .NET Core application:

  • Add a JSON file to your project called appsettings.json in the root directory of your project
  • Add a 'IronXL.LicenseKey' key to your JSON config file. The value should be your license key.
  • Ensure that the file properties include Copy to Output Directory: Copy always
  • Ensure that IronXL.License.IsLicensed returns true to verify.

File: appsettings.json

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

Step 3: Test your key

Test if your key has been installed correctly.

// 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;
' Check if a given license key string is valid.
Dim result As Boolean = IronXL.License.IsValidLicense("IRONXL-MYLICENSE-KEY-1EF01")

' Check if IronXL is licensed successfully
Dim is_licensed As Boolean = IronXL.License.IsLicensed
$vbLabelText   $csharpLabel

Note: After adding a license, always remember to clean and republish your application to avoid potential mistakes in deployment.

Step 4: Get started with your project

Follow our tutorial on how to Get Started with IronXL.

Questions?

If you have any questions, reach out to support@ironsoftware.com

Preguntas Frecuentes

¿Cómo puedo obtener una clave de licencia para mi proyecto?

Puedes obtener una clave de licencia comprándola en el sitio web de IronXL o registrándote para una prueba gratuita de 30 días.

¿Cuáles son los pasos para instalar IronXL utilizando el Administrador de Paquetes de NuGet?

Para instalar IronXL usando el Administrador de Paquetes de NuGet, abre Visual Studio, haz clic derecho sobre tu proyecto, selecciona 'Administrar paquetes NuGet...', busca IronXL.Excel, e instálalo. Alternativamente, puedes usar la Consola del Administrador de Paquetes para escribir Install-Package IronXL.Excel.

¿Cómo puedo instalar manualmente IronXL usando un DLL?

Puedes instalar manualmente IronXL descargando el DLL de Excel para .NET desde el sitio web de IronXL y agregándolo a tu proyecto de Visual Studio.

¿Cómo aplico mi clave de licencia dentro del código de mi aplicación?

Agrega la clave de licencia al código de inicio de tu aplicación usando: IronXL.License.LicenseKey = "YOUR-LICENSE-KEY".

¿Cómo puedo configurar mi clave de licencia en el archivo Web.Config para una aplicación .NET Framework?

Puedes configurar tu clave de licencia en el archivo Web.Config agregando lo siguiente en la sección appSettings: <add key="IronXL.LicenseKey" value="YOUR-LICENSE-KEY"/>.

¿Existen problemas conocidos con la concesión de licencias en ciertas versiones de IronXL?

Sí, hay un problema conocido con las versiones de IronXL 2023.4.13 - 2024.3.20 en proyectos ASP.NET y versiones del .NET Framework 4.6.2 y superiores, donde la clave almacenada en Web.config puede no ser reconocida.

¿Cómo aplico mi clave de licencia usando appsettings.json en una aplicación .NET Core?

En tu aplicación .NET Core, agrega un archivo JSON llamado appsettings.json, incluye una entrada 'IronXL.LicenseKey' con tu clave de licencia y configura la propiedad del archivo a 'Copiar en el directorio de salida: Copiar siempre'.

¿Cómo puedo verificar si mi clave de licencia de IronXL se aplica correctamente?

Para verificar tu clave de licencia, usa IronXL.License.IsValidLicense("YOUR-LICENSE-KEY") para comprobar su validez y asegúrate de que IronXL.License.IsLicensed retorne verdadero.

¿Qué pasos deben seguirse después de agregar una clave de licencia?

Después de agregar una clave de licencia, es importante limpiar y republicar tu aplicación para evitar problemas de despliegue.

¿Dónde puedo encontrar ayuda o soporte adicional?

Para obtener ayuda o soporte adicional, puedes contactar al equipo de soporte de Iron Software en support@ironsoftware.com.

¿La licencia de IronXL es totalmente compatible con proyectos y plataformas .NET 10?

Sí. Los productos de IronXL, incluyendo las licencias mediante código, Web.Config o appsettings.json, son totalmente compatibles con .NET 10 (junto con .NET 9, 8, 7, 6 y las versiones de .NET Core/Standard/Framework) sin necesidad de una configuración especial. Para aplicar una clave de licencia en .NET 10, utilice los mismos métodos que se indican en la documentación oficial: configure IronXL.License.LicenseKey en el código de inicio o utilice un archivo de configuración como appsettings.json con "IronXL.LicenseKey": "YOUR-KEY" y asegúrese de que el archivo se copie en el directorio de salida. Esto cumple con las declaraciones de compatibilidad de IronXL. ([ironsoftware.com](https://ironsoftware.com/csharp/excel/?utm_source=openai))

Curtis Chau
Curtis Chau
  Chatea con el equipo de ingeniería ahora
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más
¿Listo para empezar?
Nuget Descargas 1,686,155 | Versión: 2025.11 recién lanzado