Configure IronXL License in web.config (C#)

更新日期:6月 9, 2025

Translated

View the article in English

問題已在 IronXL 版本 2024.3.20 中解決。

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

For older IronXL versions, specifically those between versions 2023.4.13 and 2024.3.20, there is a known licensing issue in:

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

存儲在 Web.config 文件中的密鑰不會被產品識別和使用。

解決方法

為了解決此問題，建議在代碼中使用 ConfigurationManager 從 Web.config 文件中提取 License Key，然後將其應用於 License.LicenseKey 屬性。

範例：

以下是一個如何在 Web.config 文件中存儲許可密鑰的示例：

<configuration>
  ...
  <appSettings>
    <add key="IronXL.LicenseKey" value="IronXL-MYLICENSE-KEY-1EF01"/>
  </appSettings>
  ...
</configuration>

<configuration>
  ...
  <appSettings>
    <add key="IronXL.LicenseKey" value="IronXL-MYLICENSE-KEY-1EF01"/>
  </appSettings>
  ...
</configuration>

XML

通過上述 XML 文件設置，我們可以使用 ConfigurationManager 檢索許可密鑰值並將其設置為 IronXL.License.LicenseKey 屬性：

using System.Configuration;

// Retrieve the license key from the Web.config appSettings section
string licenseKey = ConfigurationManager.AppSettings["IronXL.LicenseKey"];

// Apply the retrieved license key to the IronXL component
IronXL.License.LicenseKey = licenseKey;

using System.Configuration;

// Retrieve the license key from the Web.config appSettings section
string licenseKey = ConfigurationManager.AppSettings["IronXL.LicenseKey"];

// Apply the retrieved license key to the IronXL component
IronXL.License.LicenseKey = licenseKey;

Imports System.Configuration

' Retrieve the license key from the Web.config appSettings section
Private licenseKey As String = ConfigurationManager.AppSettings("IronXL.LicenseKey")

' Apply the retrieved license key to the IronXL component
IronXL.License.LicenseKey = licenseKey

$vbLabelText $csharpLabel

在此示例中，ConfigurationManager.AppSettings 用於從 Web.config 中獲取 IronXL.LicenseKey 的值。然後將檢索到的許可密鑰設置為 IronXL.License.LicenseKey 以確保 IronXL 組件能夠正常運行。