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

已更新:2025年6月9日

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.config 文件中的密钥将不会被产品拾取和使用。

解决方法

为了解决此问题，建议在代码中使用 ConfigurationManager 从 Web.config 文件中检索许可密钥，然后将其应用于 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 组件能够正常运行。