在 Web.config 中设置许可密钥

已更新:2026年4月21日

Translated

View the article in English

自 IronPDF 版本 2024.3.3 起，该问题已得到解决。

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

对于较旧的IronPDF版本，特别是版本介于2023.4.4和2024.3.3之间的版本，存在已知的许可问题：

ASP.NET项目
.NET Framework版本 >= 4.6.2

存储在 Web.config 文件中的密钥将不会被产品识别并使用。

解决方法

为解决此问题，建议在代码中使用 ConfigurationManager 从 Web.config 文件中获取许可证密钥，然后将其应用到 License.LicenseKey 属性上。

示例：

<configuration>
  ...
  <appSettings>
    <add key="IronPdf.LicenseKey" value="IRONPDF-MYLICENSE-KEY-1EF01"/>
  </appSettings>
  ...
</configuration>

<configuration>
  ...
  <appSettings>
    <add key="IronPdf.LicenseKey" value="IRONPDF-MYLICENSE-KEY-1EF01"/>
  </appSettings>
  ...
</configuration>

XML

通过上面提供的 XML 文件，我们可以使用 ConfigurationManager 来检索许可密钥值，并将其传递给 IronPdf.License.LicenseKey 属性。

using System.Configuration;

class Program
{
    static void Main()
    {
        // Retrieve the license key from the Web.config file
        string licenseKey = ConfigurationManager.AppSettings["IronPdf.LicenseKey"];

        // Apply the license key to the IronPdf library
        IronPdf.License.LicenseKey = licenseKey;

        // Additional processing can continue here
    }
}

using System.Configuration;

class Program
{
    static void Main()
    {
        // Retrieve the license key from the Web.config file
        string licenseKey = ConfigurationManager.AppSettings["IronPdf.LicenseKey"];

        // Apply the license key to the IronPdf library
        IronPdf.License.LicenseKey = licenseKey;

        // Additional processing can continue here
    }
}

Imports System.Configuration

Friend Class Program
	Shared Sub Main()
		' Retrieve the license key from the Web.config file
		Dim licenseKey As String = ConfigurationManager.AppSettings("IronPdf.LicenseKey")

		' Apply the license key to the IronPdf library
		IronPdf.License.LicenseKey = licenseKey

		' Additional processing can continue here
	End Sub
End Class

$vbLabelText $csharpLabel