Festlegen des Lizenzschlüssels in Web.config

Curtis Chau
Curtis Chau
Updated: 29. Juni 2026

Dieses Problem wurde seit IronOCR Version 2024.3.4 behoben.

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

Bei älteren IronOCR-Versionen, insbesondere zwischen den Versionen 2023.4.13 und 2024.3.4, 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="IronOcr.LicenseKey" value="IRONOCR-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 IronOcr.License.LicenseKey zu übergeben.

using System.Configuration;

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

// Apply the license key to IronOcr to avoid licensing exceptions
IronOcr.License.LicenseKey = licenseKey;

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.

Weiterlesen

Bereit anzufangen?

Nuget Downloads 6,357,159Version:2026.11gerade veröffentlicht