Configurer la licence IronXL dans web.config (C#)

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

Ce guide de dépannage explique comment configurer correctement la clé de licence IronXL dans web.config pour les projets utilisant IronXL pour créer un fichier Excel, lire un fichier Excel ou convertir Excel en PDF.

Le problème a été résolu à partir de la version 2024.3.20 IronXL .

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

Pour les anciennes versions d'IronXL, notamment celles comprises entre les versions 2023.4.13 et 2024.3.20 , il existe un problème de licence connu :

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

La clé stockée dans un fichier Web.config ne sera PAS récupérée et utilisée par le produit.

Solution de contournement

Pour résoudre ce problème, il est recommandé de récupérer la clé de licence à partir du fichier Web.config en utilisant ConfigurationManager dans le code, puis de l'appliquer à la propriété License.LicenseKey.

Exemple :

Voici un exemple de la manière de stocker la clé de licence dans un fichier Web.config :

<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

Avec la configuration de fichier XML ci-dessus, nous pouvons utiliser ConfigurationManager pour récupérer la valeur de la clé de licence et la définir sur la propriété IronXL.License.LicenseKey :

using System.Configuration;

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

// Apply the retrieved license key to the IronXL component
IronXL.License.LicenseKey = licenseKey;
using System.Configuration;

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

// Apply the retrieved license key to the IronXL component
IronXL.License.LicenseKey = licenseKey;
Imports System.Configuration

' Retrieve the license key from the Web.config appSettings section
Private licenseKey As String = ConfigurationManager.AppSettings("IronXL.LicenseKey")

' Apply the retrieved license key to the IronXL component
IronXL.License.LicenseKey = licenseKey
$vbLabelText   $csharpLabel

Dans cet exemple, le ConfigurationManager.AppSettings est utilisé pour récupérer la valeur de IronXL.LicenseKey à partir de Web.config. La clé de licence récupérée est ensuite définie sur IronXL.License.LicenseKey pour garantir que les composants IronXL puissent fonctionner correctement.

Curtis Chau
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,950,735 | Version : 2026.4 vient de sortir
Still Scrolling Icon

Vous faites encore défiler ?

Vous voulez une preuve rapidement ? PM > Install-Package IronXL.Excel
exécuter un échantillon regarder vos données devenir une feuille de calcul.