1. IronXL
  2. Commencer
  3. Utilisation de clés de licence

Using IronXL License Keys

Curtis Chau
Curtis Chau
Mis à jour:
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

Commencez à utiliser IronXL dans votre projet aujourd'hui avec un essai gratuit.

Première étape :
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

Questions Fréquemment Posées

Comment puis-je acquérir une clé de licence pour mon projet ?

Vous pouvez acquérir une clé de licence en l'achetant sur le site IronXL ou en vous inscrivant pour un essai gratuit de 30 jours.

Quelles sont les étapes pour installer IronXL à l'aide du gestionnaire de packages NuGet ?

Pour installer IronXL en utilisant le gestionnaire de packages NuGet, ouvrez Visual Studio, cliquez à droite sur votre projet, sélectionnez 'Gérer les packages NuGet...', recherchez IronXL.Excel et installez-le. Vous pouvez également utiliser la console du gestionnaire de packages pour taper Install-Package IronXL.Excel.

Comment puis-je installer manuellement IronXL en utilisant un fichier DLL ?

Vous pouvez installer manuellement IronXL en téléchargeant le fichier DLL Excel .NET depuis le site Internet de IronXL et l'ajouter à votre projet Visual Studio.

Comment appliquer ma clé de licence dans le code de mon application ?

Ajoutez la clé de licence au code de démarrage de votre application à l'aide de : IronXL.License.LicenseKey = "YOUR-LICENSE-KEY".

Comment puis-je définir ma clé de licence dans le fichier Web.Config pour une application .NET Framework ?

Vous pouvez définir votre clé de licence dans le fichier Web.Config en ajoutant ce qui suit dans la section appSettings : <add key="IronXL.LicenseKey" value="YOUR-LICENSE-KEY"/>.

Existe-t-il des problèmes connus avec la licence dans certaines versions de IronXL?

Oui, il existe un problème connu avec les versions IronXL 2023.4.13 - 2024.3.20 dans les projets ASP.NET et les versions .NET Framework 4.6.2 et ultérieures, où la clé stockée dans Web.config peut ne pas être reconnue.

Comment appliquer ma clé de licence en utilisant appsettings.json dans une application .NET Core ?

Dans votre application .NET Core, ajoutez un fichier JSON nommé appsettings.json, incluez une entrée 'IronXL.LicenseKey' avec votre clé de licence, et définissez la propriété du fichier sur 'Copier vers le répertoire de sortie : Copier toujours'.

Comment puis-je vérifier si ma clé de licence IronXL est appliquée correctement ?

Pour vérifier votre clé de licence, utilisez IronXL.License.IsValidLicense("YOUR-LICENSE-KEY") pour vérifier sa validité, et assurez-vous que IronXL.License.IsLicensed retourne true.

Quelles étapes doivent être effectuées après avoir ajouté une clé de licence ?

Après avoir ajouté une clé de licence, il est important de nettoyer et republier votre application pour éviter les problèmes de déploiement.

Où puis-je trouver une aide ou un support supplémentaire ?

Pour une aide ou un support supplémentaire, vous pouvez contacter l'équipe de support Iron Software à support@ironsoftware.com.

La licence d'IronXL est-elle entièrement prise en charge sur les projets et plateformes .NET 10 ?

Oui. Les produits IronXL, y compris la gestion des licences par code, Web.config ou appsettings.json, sont entièrement compatibles avec .NET 10 (ainsi qu'avec .NET 9, 8, 7, 6 et les versions .NET Core/Standard/Framework) sans configuration particulière. Pour appliquer une clé de licence sous .NET 10, utilisez les méthodes décrites dans la documentation officielle : définissez la propriété IronXL.License.LicenseKey dans le code de démarrage ou utilisez un fichier de configuration tel que appsettings.json avec "IronXL.LicenseKey": "YOUR-KEY" et assurez-vous que le fichier est copié dans le répertoire de sortie. Ceci est conforme aux déclarations de compatibilité d'IronXL. ([ironsoftware.com](https://ironsoftware.com/csharp/excel/?utm_source=openai))

Curtis Chau
Curtis Chau
  Discutez maintenant avec l'équipe d'ingénierie
Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Lire la suite
Prêt à commencer?
Nuget Téléchargements 1,686,155 | Version : 2025.11 vient de sortir