Setting License Key in Web.config

ByChaknith Bin

May 31, 2025

Updated June 22, 2025

The problem has been resolved as of IronQR version 2024.3.2.

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

For older IronQR versions, specifically those released before version 2024.3.2, 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="IronQR.LicenseKey" value="IronQR-MYLICENSE-KEY-1EF01"/>
  </appSettings>
  ...
</configuration>

<configuration>
  ...
  <appSettings>
    <add key="IronQR.LicenseKey" value="IronQR-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 IronQR.License.LicenseKey property.

using System.Configuration;

// Retrieve the license key from the Web.config file's appSettings section
string licenseKey = ConfigurationManager.AppSettings["IronQR.LicenseKey"];

// Apply the retrieved license key to the IronQR LicenseKey property
IronQR.License.LicenseKey = licenseKey;

using System.Configuration;

// Retrieve the license key from the Web.config file's appSettings section
string licenseKey = ConfigurationManager.AppSettings["IronQR.LicenseKey"];

// Apply the retrieved license key to the IronQR LicenseKey property
IronQR.License.LicenseKey = licenseKey;

Imports System.Configuration

' Retrieve the license key from the Web.config file's appSettings section
Private licenseKey As String = ConfigurationManager.AppSettings("IronQR.LicenseKey")

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

$vbLabelText $csharpLabel

Chaknith Bin

Chat with engineering team now

Software Engineer

Chaknith works on IronXL and IronBarcode. He has deep expertise in C# and .NET, helping improve the software and support customers. His insights from user interactions contribute to better products, documentation, and overall experience.