在 web.config 中設定 IronOCR 許可證

更新:6月 1, 2025

Translated

View the article in English

從 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 屬性。

Example:

<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

$vbLabelText $csharpLabel

using System.Configuration;指令允許存取設定文件，例如Web.config 。
ConfigurationManager.AppSettings["IronZip.LicenseKey"]擷取儲存在Web.config的appSettings部分中的授權金鑰。
IronZip.License.LicenseKey = licenseKey;將擷取的金鑰指派給 IronZip 庫，以避免許可異常。
Console.WriteLine()語句向開發人員提供回饋，表示許可證金鑰申請程序已成功完成。