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

Utilisation des clés de licence IronXL

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

Comment obtenir une clé de licence

L'ajout d'une clé de licence IronXL vous permet de déployer votre projet en production sans restrictions ni filigranes. Cela est requis pour tout projet qui crée un fichier Excel, lit un fichier Excel ou convertit Excel en PDF en environnement live.

Vous pouvez acheter une clé de licence ou vous inscrire pour obtenir une clé d'essai gratuite de 30 jours ici.

Étape 1 : Téléchargez la dernière version d'IronXL

La première chose à faire est d'installer la bibliothèque IronXL.Excel, qui ajoute les fonctionnalités d'Excel au framework .NET.

Installer avec le package NuGet

  1. Dans Visual Studio, cliquez avec le bouton droit sur le projet et sélectionnez " Gérer les packages NuGet… "
  2. Recherchez le package IronXL.Excel et installez-le.

Ou

  1. Accédez à la console du gestionnaire de packages

  2. Type :

    Install-Package IronXL.Excel

Vous pouvez consulter le package sur le site NuGet ici.

Installation par téléchargement direct de la DLL

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

Étape 2 : Appliquez votre clé de licence

Définissez la clé de licence dans votre code

Ajoutez ce code au démarrage de votre application, avant l'utilisation d'IronXL.

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

Définissez votre clé en utilisant Web.Config ou App.Config dans les applications .NET Framework

Pour appliquer une clé globalement à votre application à l'aide de Web.Config ou App.Config, ajoutez la clé suivante à votre fichier de configuration dans 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

Il existe un problème de licence connu entre les versions 2023.4.13 et 2024.3.20 d'IronXL sur le projet :

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

La clé stockée dans un fichier Web.config n'est PAS détectée et utilisée par le produit. Consultez l'article de dépannage " Définition de la clé de licence dans Web.config " pour en savoir plus.

Assurez-vous que IronXL.License.IsLicensed renvoie true pour vérification.

Définissez votre clé en utilisant un fichier .NET Core appsettings.json

Pour appliquer une clé globalement à votre application .NET Core :

  • Ajoutez un fichier JSON à votre projet, nommé appsettings.json, dans le répertoire racine de votre projet.
  • Ajoutez une clé " IronXL.LicenseKey " à votre fichier de configuration JSON. Sa valeur doit correspondre à votre clé de licence.
  • Assurez-vous que les propriétés du fichier incluent " Copier dans le répertoire de sortie : Copier toujours "
  • Assurez-vous que IronXL.License.IsLicensed renvoie true pour vérification.

Fichier : appsettings.json

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

Étape 3 : Testez votre clé

Vérifiez si votre clé a été installée correctement.

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

Remarque : Après avoir ajouté une licence, n'oubliez pas de nettoyer et republier votre application pour éviter d'éventuelles erreurs lors du déploiement.

Étape 4 : Commencez avec votre projet

Suivez notre tutoriel sur la façon de démarrer avec IronXL .

Des questions ?

Si vous avez des questions, contactez 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 : .

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,974,422 | 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.