在 web.config 中配置 IronXL 许可证（C#）

Updated: 2026年5月9日

问题已在IronXL版本2024.3.20得到解决。

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

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

Text

对于较旧的 IronXL 版本，特别是2023.4.13到2024.3.20之间的版本，存在已知的许可问题：

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

存储在Web.config文件中的密钥不会被产品拾取和使用。

解决方法

为解决这个问题，建议在代码中使用ConfigurationManager从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
Dim licenseKey As String = 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
Dim licenseKey As String = ConfigurationManager.AppSettings("IronXL.LicenseKey")

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

在此示例中，使用Web.config。检索到的许可证密钥然后被设置为IronXL.License.LicenseKey以确保IronXL组件能够正常工作。