在 Web.config 中设置许可证密钥

Updated: 2026年6月29日

此问题已在 IronOCR 2024.3.4 版本中得到解决。

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

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

Text

对于较旧的 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

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