web.config 中的 IronOCR 许可证配置

Updated: 2026年4月22日

该问题已在 IronZip 2024.3.3 版本中得到解决。

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

对于较早版本的 IronZip（特别是 2024.3.3 版之前的版本），存在已知的许可问题：

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

存储在 Web.config 文件中的密钥将不会被产品识别并使用。

解决方法

为解决此问题，建议在代码中使用 ConfigurationManager 从 Web.config 文件中获取许可证密钥，然后将其应用到 License.LicenseKey 属性上。

示例：

<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

利用上文提供的 XML 文件，我们可以使用 ConfigurationManager 检索许可证密钥值，并将其传递给 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.");
    }
}

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

using System.Configuration; 指令允许访问配置文件，例如 Web.config。
ConfigurationManager.AppSettings["IronZip.LicenseKey"] 会从 Web.config 的 appSettings 部分中检索许可证密钥。
IronZip.License.LicenseKey = licenseKey; 将检索到的密钥分配给 IronZIP库，以避免许可异常。
Console.WriteLine() 语句向开发者反馈许可证密钥申请流程已成功完成。