IronPrint 授權設定疑難排解

更新:2026年4月21日

Translated

View the article in English

此問題已於 IronPrint 版本 2024.3.6 解決。

# This shell output shows an unhandled exception error due to missing license for IronPrint.
Exception: Unhandled exception. IronSoftware.Exceptions.LicensingException: IronPrint must be licensed for development.

# This shell output shows an unhandled exception error due to missing license for IronPrint.
Exception: Unhandled exception. IronSoftware.Exceptions.LicensingException: IronPrint must be licensed for development.

SHELL

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

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

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

解決方案

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

範例：

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

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

XML

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

using System;
using System.Co/nfiguration;

namespace IronPrintLicenseSetup
{
    class Program
    {
        static void Main()
        {
            // Retrieve the license key from the appSettings section of the Web.co/nfig file.
            string licenseKey = ConfigurationManager.AppSettings["IronPrint.LicenseKey"];

            // Apply the retrieved license key to the IronPrint's LicenseKey property.
            IronPrint.License.LicenseKey = licenseKey;

            // Notify user that the license key has been applied.
            Console.WriteLine("License Key has been applied successfully.");
        }
    }
}

using System;
using System.Co/nfiguration;

namespace IronPrintLicenseSetup
{
    class Program
    {
        static void Main()
        {
            // Retrieve the license key from the appSettings section of the Web.co/nfig file.
            string licenseKey = ConfigurationManager.AppSettings["IronPrint.LicenseKey"];

            // Apply the retrieved license key to the IronPrint's LicenseKey property.
            IronPrint.License.LicenseKey = licenseKey;

            // Notify user that the license key has been applied.
            Console.WriteLine("License Key has been applied successfully.");
        }
    }
}

Imports System
Imports System.Configuration

Namespace IronPrintLicenseSetup
    Class Program
        Shared Sub Main()
            ' Retrieve the license key from the appSettings section of the Web.config file.
            Dim licenseKey As String = ConfigurationManager.AppSettings("IronPrint.LicenseKey")

            ' Apply the retrieved license key to the IronPrint's LicenseKey property.
            IronPrint.License.LicenseKey = licenseKey

            ' Notify user that the license key has been applied.
            Console.WriteLine("License Key has been applied successfully.")
        End Sub
    End Class
End Namespace

$vbLabelText $csharpLabel

在上述範例中，ConfigurationManager.AppSettings 用於直接從 Web.co/nfig 擷取授權金鑰。接著將 IronPrint 元件的金鑰設定為 LicenseKey，以確保應用程式具備正確運作所需的授權。