IronPrint 许可证配置故障排除

已更新:六月 1, 2025

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 属性。

Example:

<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.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 ，以确保应用程序拥有正确运行所需的许可证。