Setting License Key in Web.config

Actualizado:junio 1, 2025

Translated

View the article in English

This problem has been solved since IronPDF version 2024.3.3.

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

For older IronPdf versions, specifically those between versions 2023.4.4 and 2024.3.3, there is a known licensing issue in:

ASP.NET projects
.NET Framework version >= 4.6.2

The key stored in a Web.config file will NOT be picked up and used by the product.

Workaround

To address this issue, it is recommended to retrieve the license key from the Web.config file using ConfigurationManager in the code, and then apply it to the License.LicenseKey property.

Example:

<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

With the XML file provided above, we can use ConfigurationManager to retrieve the license key value and pass it to the IronPdf.License.LicenseKey property.

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

Curtis Chau

Chatea con el equipo de ingeniería ahora

Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

¿Listo para empezar?

Nuget Descargas 16,154,058 | Versión: 2025.11 recién lanzado