Konfiguracja licencji IronOCR w pliku web.config

Curtis Chau
Curtis Chau
Updated: 22 kwietnia 2026

Problem został rozwiązany w wersji IronZIP 2024.3.3.

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

W przypadku starszych wersji IronZip, a konkretnie tych wydanych przed wersją 2024.3.3, występuje znany problem z licencjonowaniem w:

  • Projekty ASP.NET
  • .NET Framework w wersji >= 4.6.2

Klucz zapisany w pliku Web.config NIE zostanie pobrany i wykorzystany przez produkt.

Rozwiązanie

Aby rozwiązać ten problem, zaleca się pobranie klucza licencyjnego z pliku Web.config za pomocą ConfigurationManager w kodzie, a następnie zastosowanie go do właściwości License.LicenseKey.

Przykład:

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

Korzystając z pliku XML podanego powyżej, możemy użyć ConfigurationManager do pobrania wartości klucza licencyjnego i przekazania go do właściwości 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.");
    }
}
  • Dyrektywa using System.Configuration; umożliwia dostęp do plików konfiguracyjnych, takich jak Web.config.
  • ConfigurationManager.AppSettings["IronZip.LicenseKey"] pobiera klucz licencyjny zapisany w sekcji appSettings pliku Web.config.
  • IronZip.License.LicenseKey = licenseKey; przypisuje pobrany klucz do biblioteki IronZIP, aby uniknąć wyjątków licencyjnych.
  • Instrukcja Console.WriteLine() informuje programistę, że proces ubiegania się o klucz licencyjny zakończył się pomyślnie.

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

Czytaj więcej

Gotowy, aby rozpocząć?

Nuget Downloads 24,981Wersja:2026.11właśnie wydany