web.config 中的 IronOCR 授權設定
Curtis Chau
Updated: 2026年4月22日
此問題已於 IronZip 版本 2024.3.3 解決。
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>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.");
}
}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 ClassImports 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 Classusing System.Configuration;指令可存取設定檔，例如Web.config。ConfigurationManager.AppSettings["IronZip.LicenseKey"]會從appSettings區段中讀取Web.config所儲存的授權金鑰。IronZip.License.LicenseKey = licenseKey;會將擷取到的金鑰指派給 IronZIP程式庫，以避免觸發授權例外狀況。Console.WriteLine()語句會向開發人員回報，表示授權金鑰申請流程已成功完成。
Curtis Chau擁有Carleton大學的電腦科學學士學位，專精於前端開發，擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面，喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。
