Configuration de la licence IronOCR dans web.config

Updated: 22 avril 2026

Le problème a été résolu à partir de la version 2024.3.3 d'IronZip.

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

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

SHELL

Pour les anciennes versions d'IronZip, en particulier celles publiées avant la version 2024.3.3, il existe un problème de licence connu dans :

Projets ASP.NET
.NET Framework version >= 4.6.2

La clé stockée dans un fichier Web.config ne sera PAS récupérée ni 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 à l'aide de ConfigurationManager dans le code, puis de l'appliquer à la propriété License.LicenseKey.

Exemple :

<configuration>
  ...
  <appSettings>
    <add key="IronZip.LicenseKey" value="IRONZIP.MYLICENSE.KEY.1EF01"/>
  </appSettings>
  ...
</configuration>

<configuration>
  ...
  <appSettings>
    <add key="IronZip.LicenseKey" value="IRONZIP.MYLICENSE.KEY.1EF01"/>
  </appSettings>
  ...
</configuration>

XML

À l'aide du fichier XML fourni ci-dessus, nous pouvons utiliser ConfigurationManager pour récupérer la valeur de la clé de licence et la transmettre à la propriété IronZip.License.LicenseKey.

using System;
using System.Configuration;

class Program
{
    static void Main()
    {
        // Retrieve the license key from the web.config appSettings
        string licenseKey = ConfigurationManager.AppSettings["IronZip.LicenseKey"];

        // Apply the license key to IronZip
        IronZip.License.LicenseKey = licenseKey;

        // Verify that the license key is set properly
        Console.WriteLine("License key applied successfully.");
    }
}

using System;
using System.Configuration;

class Program
{
    static void Main()
    {
        // Retrieve the license key from the web.config appSettings
        string licenseKey = ConfigurationManager.AppSettings["IronZip.LicenseKey"];

        // Apply the license key to IronZip
        IronZip.License.LicenseKey = licenseKey;

        // Verify that the license key is set properly
        Console.WriteLine("License key applied successfully.");
    }
}

Imports System
Imports System.Configuration

Friend Class Program
	Shared Sub Main()
		' Retrieve the license key from the web.config appSettings
		Dim licenseKey As String = ConfigurationManager.AppSettings("IronZip.LicenseKey")

		' Apply the license key to IronZip
		IronZip.License.LicenseKey = licenseKey

		' Verify that the license key is set properly
		Console.WriteLine("License key applied successfully.")
	End Sub
End Class

Imports System
Imports System.Configuration

Friend Class Program
	Shared Sub Main()
		' Retrieve the license key from the web.config appSettings
		Dim licenseKey As String = ConfigurationManager.AppSettings("IronZip.LicenseKey")

		' Apply the license key to IronZip
		IronZip.License.LicenseKey = licenseKey

		' Verify that the license key is set properly
		Console.WriteLine("License key applied successfully.")
	End Sub
End Class

La directive using System.Configuration; permet d'accéder à des fichiers de configuration, tels que Web.config.
ConfigurationManager.AppSettings["IronZip.LicenseKey"] récupère la clé de licence stockée dans la section appSettings de Web.config.
IronZip.License.LicenseKey = licenseKey; attribue la clé récupérée à la bibliothèque IronZIP afin d'éviter les exceptions de licence.
L'instruction Console.WriteLine() indique au développeur que le processus de demande de clé de licence s'est déroulé avec succès.

Curtis Chau

Rédacteur technique

Discutez maintenant avec l'équipe d'ingénierie

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 et créer des manuels bien structurés et visuellement attrayants.