在 Web.config 中設定許可證金鑰

更新:2025年6月9日

Translated

View the article in English

自 IronOCR 版本2024.3.4起，此問題已解決。

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

對於較舊的 IronOcr 版本，特別是2023.4.13到2024.3.4之間的版本，存在已知的許可問題：

ASP.NET項目
.NET Framework 版本 >= 4.6.2

儲存在Web.config檔中的金鑰不會被產品讀取和使用。

解決方法

為了解決這個問題，建議使用程式碼中的ConfigurationManager從Web.config檔案中擷取許可證金鑰，然後將其套用至 License.LicenseKey 屬性。

例子：

<configuration>
  ...
  <appSettings>
    <add key="IronOcr.LicenseKey" value="IRONOCR-MYLICENSE-KEY-1EF01"/>
  </appSettings>
  ...
</configuration>

<configuration>
  ...
  <appSettings>
    <add key="IronOcr.LicenseKey" value="IRONOCR-MYLICENSE-KEY-1EF01"/>
  </appSettings>
  ...
</configuration>

XML

使用上面提供的 XML 文件，我們可以使用ConfigurationManager檢索許可證金鑰值並將其傳遞給IronOcr.License.LicenseKey屬性。

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;

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;

Imports System.Configuration

' Retrieve the license key from the Web.config's appSettings
Private licenseKey As String = ConfigurationManager.AppSettings("IronOcr.LicenseKey")

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

$vbLabelText $csharpLabel