在 web.config 中設定IronOCR許可證

更新:2025年6月1日

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

例子：

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

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"] 檢索儲存在 appSettings 部分中的許可證金鑰 Web.config。
IronZip.License.LicenseKey = licenseKey; 將檢索到的金鑰指派給IronZIP函式庫，以避免許可例外情況。
Console.WriteLine() 語句向開發者提供回饋，表示許可證金鑰申請流程已成功完成。