IronPrint授權配置故障排除

更新:2025年6月1日

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.config 檔案中的金鑰不會被產品讀取和使用。

解決方法

為了解決這個問題，建議使用程式碼中的ConfigurationManager從 Web.config 檔案中擷取許可證金鑰，然後將其套用至 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屬性。

using System;
using System.Configuration;

namespace IronPrintLicenseSetup
{
    class Program
    {
        static void Main()
        {
            // Retrieve the license key from the appSettings section of the Web.config 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.Configuration;

namespace IronPrintLicenseSetup
{
    class Program
    {
        static void Main()
        {
            // Retrieve the license key from the appSettings section of the Web.config 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
	Friend 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.config 取得許可證金鑰。然後，將金鑰設定為IronPrint組件的 LicenseKey，以確保應用程式擁有正確運行所需的授權。