在 web.co/nfig 中配置 IronXL 许可证（C#）

已更新:2026年4月21日

Translated

View the article in English

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

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

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

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

存储在 Web.co/nfig 文件中的密钥将不会被产品读取和使用。

解决方法

为解决此问题，建议在代码中使用 ConfigurationManager 从 Web.co/nfig 文件中获取许可证密钥，然后将其应用到 License.LicenseKey 属性上。

示例：

以下是一个将许可证密钥存储在 Web.co/nfig 文件中的示例：

<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.Co/nfiguration;

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

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

using System.Co/nfiguration;

// Retrieve the license key from the Web.co/nfig 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

$vbLabelText $csharpLabel

在此示例中，ConfigurationManager.AppSettings 用于从 Web.co/nfig 中检索 IronXl.LicenseKey 的值。随后将检索到的许可证密钥设置为 IronXl.License.LicenseKey，以确保 IronXL 组件能够正常运行。