Einrichtung der IronOCR-Lizenz in web.config

Updated: 22. April 2026

Das Problem wurde ab IronZip-Version 2024.3.3 behoben.

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

Bei älteren IronZip-Versionen, insbesondere solchen, die vor Version 2024.3.3 veröffentlicht wurden, gibt es ein bekanntes Lizenzproblem in:

ASP.NET-Projekte
.NET Framework Version >= 4.6.2

Der in einer Web.config-Datei gespeicherte Schlüssel wird vom Produkt NICHT erfasst und verwendet.

Workaround

Um dieses Problem zu beheben, wird empfohlen, den Lizenzschlüssel mithilfe von ConfigurationManager im Code aus der Datei Web.config abzurufen und ihn dann auf die Eigenschaft License.LicenseKey anzuwenden.

Beispiel:

<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

Mit der oben bereitgestellten XML-Datei können wir den ConfigurationManager verwenden, um den Wert des Lizenzschlüssels abzurufen und ihn an die Eigenschaft IronZip.License.LicenseKey zu übergeben.

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

Die Anweisung using System.Configuration; ermöglicht den Zugriff auf Konfigurationsdateien, wie beispielsweise Web.config.
ConfigurationManager.AppSettings["IronZip.LicenseKey"] ruft den Lizenzschlüssel ab, der im Abschnitt appSettings von Web.config gespeichert ist.
IronZip.License.LicenseKey = licenseKey; weist der IronZIP-Bibliothek den abgerufenen Schlüssel zu, um Lizenzausnahmen zu vermeiden.
Die Anweisung Console.WriteLine() gibt dem Entwickler die Rückmeldung, dass der Anwendungsprozess für den Lizenzschlüssel erfolgreich abgeschlossen wurde.

Curtis Chau

Jetzt mit dem Ingenieurteam chatten

Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.

...