ASP.NET 設定中的 IronWord 授權金鑰

Updated: 2026年6月29日

此問題已於 IronWord 2024.3.5 版本中解決。

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

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

Text

針對較舊的 IronWord 版本，特別是 2024.3.5 版之前發佈的版本，存在已知的授權問題：

ASP.NET 專案
.NET Framework 版本 >= 4.6.2

儲存於 Web.config 檔案中的金鑰，產品將不會讀取並使用。

解決方案

為解決此問題，建議在程式碼中使用 ConfigurationManager 從 Web.config 檔案中擷取授權金鑰，然後將其套用至 License.LicenseKey 屬性。

範例：

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

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

XML

透過上述提供的 XML 檔案，我們可以使用 ConfigurationManager 取得授權金鑰值，並將其傳遞給 IronWord.License.LicenseKey 屬性。

// Import the necessary namespace for ConfigurationManager
using System.Configuration;

// Retrieve the license key from the AppSettings in Web.config
string licenseKey = ConfigurationManager.AppSettings["IronWord.LicenseKey"];

// Set the license key for IronWord
IronWord.License.LicenseKey = licenseKey;

// Import the necessary namespace for ConfigurationManager
using System.Configuration;

// Retrieve the license key from the AppSettings in Web.config
string licenseKey = ConfigurationManager.AppSettings["IronWord.LicenseKey"];

// Set the license key for IronWord
IronWord.License.LicenseKey = licenseKey;

' Import the necessary namespace for ConfigurationManager
Imports System.Configuration

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

' Set the license key for IronWord
IronWord.License.LicenseKey = licenseKey

' Import the necessary namespace for ConfigurationManager
Imports System.Configuration

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

' Set the license key for IronWord
IronWord.License.LicenseKey = licenseKey