在 web.config 中設定IronXL許可證：XLSX檔案操作授權指南

更新:2026年1月31日

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元件能夠正常運作。