The Two-Key System Explained

BarcodeXpress splits licensing into two conceptually separate layers:

// BarcodeXpress: two separate license keys required
using Accusoft.BarcodeXpressSdk;

// Constructor takes the path to the runtime files (e.g. ".").
var barcodeXpress = new BarcodeXpress(".");

// Step 1: SDK license (for development).
// SetSolutionName and SetSolutionKey are methods, not properties.
// SetSolutionKey takes four 32-bit integers (not a parsed long).
barcodeXpress.Licensing.SetSolutionName("YourCompanyName");
barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4);

// Step 2: OEM/runtime license (for production — minimum 5 purchased).
try
{
    barcodeXpress.Licensing.SetOEMLicenseKey("YourOEMLicenseString");
}
catch (Exception ex)
{
    // Without a valid OEM license, the SDK runs in stamped evaluation mode.
    Console.WriteLine($"OEM license activation failed: {ex.Message}");
}

// BarcodeXpress: two separate license keys required
using Accusoft.BarcodeXpressSdk;

// Constructor takes the path to the runtime files (e.g. ".").
var barcodeXpress = new BarcodeXpress(".");

// Step 1: SDK license (for development).
// SetSolutionName and SetSolutionKey are methods, not properties.
// SetSolutionKey takes four 32-bit integers (not a parsed long).
barcodeXpress.Licensing.SetSolutionName("YourCompanyName");
barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4);

// Step 2: OEM/runtime license (for production — minimum 5 purchased).
try
{
    barcodeXpress.Licensing.SetOEMLicenseKey("YourOEMLicenseString");
}
catch (Exception ex)
{
    // Without a valid OEM license, the SDK runs in stamped evaluation mode.
    Console.WriteLine($"OEM license activation failed: {ex.Message}");
}

Imports Accusoft.BarcodeXpressSdk

' BarcodeXpress: two separate license keys required

' Constructor takes the path to the runtime files (e.g. ".").
Dim barcodeXpress As New BarcodeXpress(".")

' Step 1: SDK license (for development).
' SetSolutionName and SetSolutionKey are methods, not properties.
' SetSolutionKey takes four 32-bit integers (not a parsed long).
barcodeXpress.Licensing.SetSolutionName("YourCompanyName")
barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4)

' Step 2: OEM/runtime license (for production — minimum 5 purchased).
Try
    barcodeXpress.Licensing.SetOEMLicenseKey("YourOEMLicenseString")
Catch ex As Exception
    ' Without a valid OEM license, the SDK runs in stamped evaluation mode.
    Console.WriteLine($"OEM license activation failed: {ex.Message}")
End Try

The SetSolutionName/SetSolutionKey pair activates the SDK itself. The SetOEMLicenseKey call activates production deployment capabilities. Both must be present and valid for a production deployment to return barcode values without the " UNLICENSED accusoft.com " stamp.

In code review, this pattern produces a predictable question: "Why do we have two separate license activations?" The answer — that Accusoft treats SDK licensing and deployment licensing as separate products with separate billing — is not always obvious from the API itself. Teams maintaining this code six months after initial setup often need to trace back to documentation to understand which key is which.

Without a valid OEM license, SetOEMLicenseKey throws and the SDK falls back to evaluation mode. Teams typically wrap activation in try/catch so the failure is logged loudly rather than silently producing stamped barcode values in production:

try
{
    barcodeXpress.Licensing.SetOEMLicenseKey(oemKey);
}
catch (Exception ex)
{
    // In evaluation mode, barcode values are stamped with
    // " UNLICENSED accusoft.com " in the output.
    throw new InvalidOperationException(
        "OEM license activation failed — barcode values will be stamped", ex);
}

try
{
    barcodeXpress.Licensing.SetOEMLicenseKey(oemKey);
}
catch (Exception ex)
{
    // In evaluation mode, barcode values are stamped with
    // " UNLICENSED accusoft.com " in the output.
    throw new InvalidOperationException(
        "OEM license activation failed — barcode values will be stamped", ex);
}

Try
    barcodeXpress.Licensing.SetOEMLicenseKey(oemKey)
Catch ex As Exception
    ' In evaluation mode, barcode values are stamped with
    ' " UNLICENSED accusoft.com " in the output.
    Throw New InvalidOperationException("OEM license activation failed — barcode values will be stamped", ex)
End Try

This guard is the pattern teams add when they realize that evaluation-mode output silently stamps results rather than throwing during decoding.

Detailed Feature Comparison

BarcodeXpress Approach

using Accusoft.BarcodeXpressSdk;

public class BarcodeService
{
    private readonly BarcodeXpress _barcodeXpress;

    public BarcodeService()
    {
        _barcodeXpress = new BarcodeXpress(".");

        // Layer 1: SDK license
        _barcodeXpress.Licensing.SetSolutionName("AcmeCorp");
        _barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4);

        // Layer 2: OEM/runtime license — separate purchase, minimum 5
        try
        {
            _barcodeXpress.Licensing.SetOEMLicenseKey("OEMLicenseString");
        }
        catch (Exception ex)
        {
            throw new InvalidOperationException(
                "OEM license activation failed — barcode values will be stamped", ex);
        }
    }
}

using Accusoft.BarcodeXpressSdk;

public class BarcodeService
{
    private readonly BarcodeXpress _barcodeXpress;

    public BarcodeService()
    {
        _barcodeXpress = new BarcodeXpress(".");

        // Layer 1: SDK license
        _barcodeXpress.Licensing.SetSolutionName("AcmeCorp");
        _barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4);

        // Layer 2: OEM/runtime license — separate purchase, minimum 5
        try
        {
            _barcodeXpress.Licensing.SetOEMLicenseKey("OEMLicenseString");
        }
        catch (Exception ex)
        {
            throw new InvalidOperationException(
                "OEM license activation failed — barcode values will be stamped", ex);
        }
    }
}

Imports Accusoft.BarcodeXpressSdk

Public Class BarcodeService
    Private ReadOnly _barcodeXpress As BarcodeXpress

    Public Sub New()
        _barcodeXpress = New BarcodeXpress(".")

        ' Layer 1: SDK license
        _barcodeXpress.Licensing.SetSolutionName("AcmeCorp")
        _barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4)

        ' Layer 2: OEM/runtime license — separate purchase, minimum 5
        Try
            _barcodeXpress.Licensing.SetOEMLicenseKey("OEMLicenseString")
        Catch ex As Exception
            Throw New InvalidOperationException("OEM license activation failed — barcode values will be stamped", ex)
        End Try
    End Sub
End Class

This constructor exists entirely to manage two separate license activations before any barcode operation can take place. The try/catch around SetOEMLicenseKey is not optional — without it, the service will silently return stamped values in any environment where the OEM key is missing or misconfigured.

IronBarcode Approach

using IronBarCode;

// In Program.cs or startup configuration
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

using IronBarCode;

// In Program.cs or startup configuration
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

Imports IronBarCode

' In Program.vb or startup configuration
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

That is the complete licensing setup. No separate runtime unlock, no solution name, no two-argument UnlockRuntime call. In Docker, this becomes an environment variable read at startup. In a CI/CD pipeline, it is one secret. In a container orchestrator, it is one environment variable injected into the pod.

BarcodeXpress Approach

Reading with BarcodeXpress requires loading the image into a System.Drawing.Bitmap, assigning the symbology set to reader.BarcodeTypes as a System.Array of BarcodeType values, and calling Analyze(bitmap) to retrieve results. The SDK does not read PDFs directly — documented input formats are TIFF, JPEG, PNG, and BMP:

using Accusoft.BarcodeXpressSdk;
using System.Drawing;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var barcodeXpress = new BarcodeXpress(".");
    barcodeXpress.Licensing.SetSolutionName("AcmeCorp");
    barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4);
    barcodeXpress.Licensing.SetOEMLicenseKey("OEMLicenseString");

    using var bitmap = new Bitmap(imagePath);

    // BarcodeTypes is a System.Array of BarcodeType values (not a [Flags]
    // enum). Pass Enum.GetValues to scan for everything, or assign a
    // narrower array to restrict the search space.
    barcodeXpress.reader.BarcodeTypes = new[]
    {
        BarcodeType.Code128Barcode,
        BarcodeType.DataMatrixBarcode,
        BarcodeType.QRCodeBarcode
    };

    Result[] results = barcodeXpress.reader.Analyze(bitmap);
    return results.Select(r => r.BarcodeValue);
}

using Accusoft.BarcodeXpressSdk;
using System.Drawing;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var barcodeXpress = new BarcodeXpress(".");
    barcodeXpress.Licensing.SetSolutionName("AcmeCorp");
    barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4);
    barcodeXpress.Licensing.SetOEMLicenseKey("OEMLicenseString");

    using var bitmap = new Bitmap(imagePath);

    // BarcodeTypes is a System.Array of BarcodeType values (not a [Flags]
    // enum). Pass Enum.GetValues to scan for everything, or assign a
    // narrower array to restrict the search space.
    barcodeXpress.reader.BarcodeTypes = new[]
    {
        BarcodeType.Code128Barcode,
        BarcodeType.DataMatrixBarcode,
        BarcodeType.QRCodeBarcode
    };

    Result[] results = barcodeXpress.reader.Analyze(bitmap);
    return results.Select(r => r.BarcodeValue);
}

Imports Accusoft.BarcodeXpressSdk
Imports System.Drawing

Public Function ReadAllBarcodes(imagePath As String) As IEnumerable(Of String)
    Dim barcodeXpress = New BarcodeXpress(".")
    barcodeXpress.Licensing.SetSolutionName("AcmeCorp")
    barcodeXpress.Licensing.SetSolutionKey(1, 2, 3, 4)
    barcodeXpress.Licensing.SetOEMLicenseKey("OEMLicenseString")

    Using bitmap As New Bitmap(imagePath)
        ' BarcodeTypes is a System.Array of BarcodeType values (not a [Flags]
        ' enum). Pass Enum.GetValues to scan for everything, or assign a
        ' narrower array to restrict the search space.
        barcodeXpress.Reader.BarcodeTypes = New BarcodeType() {
            BarcodeType.Code128Barcode,
            BarcodeType.DataMatrixBarcode,
            BarcodeType.QRCodeBarcode
        }

        Dim results As Result() = barcodeXpress.Reader.Analyze(bitmap)
        Return results.Select(Function(r) r.BarcodeValue)
    End Using
End Function

Analyze takes a Bitmap and returns a Result[]. If a document contains a format not present in the BarcodeTypes array, it will not be found. This becomes maintenance overhead when document sources change. PDFs require pre-rendering to images with a separate library before they can be fed into Analyze.

IronBarcode Approach

using IronBarCode;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var results = BarcodeReader.Read(imagePath);
    return results.Select(r => r.Value);
}

using IronBarCode;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var results = BarcodeReader.Read(imagePath);
    return results.Select(r => r.Value);
}

Imports IronBarCode

Public Function ReadAllBarcodes(imagePath As String) As IEnumerable(Of String)
    Dim results = BarcodeReader.Read(imagePath)
    Return results.Select(Function(r) r.Value)
End Function

IronBarcode auto-detects format across all supported symbologies. If the image contains a Code 128, a QR code, and a DataMatrix, all three come back in the results collection without any configuration change. For more control over reading behavior, the BarcodeReaderOptions class exposes speed, thread count, and multi-barcode settings.

Native PDF reading is also available through the same method:

using IronBarCode;

// Native PDF support — no separate library needed
var results = BarcodeReader.Read("invoice-batch.pdf");

foreach (var result in results)
{
    Console.WriteLine($"Page {result.PageNumber}: [{result.Format}] {result.Value}");
}

using IronBarCode;

// Native PDF support — no separate library needed
var results = BarcodeReader.Read("invoice-batch.pdf");

foreach (var result in results)
{
    Console.WriteLine($"Page {result.PageNumber}: [{result.Format}] {result.Value}");
}

Imports IronBarCode

' Native PDF support — no separate library needed
Dim results = BarcodeReader.Read("invoice-batch.pdf")

For Each result In results
    Console.WriteLine($"Page {result.PageNumber}: [{result.Format}] {result.Value}")
Next

BarcodeXpress does not read PDFs natively. You need to render each page to an image first, using a separate library, then pass those images to the BarcodeXpress reader. That adds a dependency, adds a conversion step, and adds another licensing cost depending on the PDF library chosen.

BarcodeXpress Approach

BarcodeXpress is instance-based and its reader object is stateful. Parallel processing requires one instance per thread, with the full two-layer license initialization repeated in each thread context:

using Accusoft.BarcodeXpressSdk;
using System.Collections.Generic;
using System.Drawing;

public Dictionary<string, string> ProcessBatch(IEnumerable<string> imagePaths)
{
    var results = new Dictionary<string, string>();

    foreach (var path in imagePaths)
    {
        using var bitmap = new Bitmap(path);

        _barcodeXpress.reader.BarcodeTypes = new[]
        {
            BarcodeType.Code128Barcode,
            BarcodeType.QRCodeBarcode
        };

        var barcodes = _barcodeXpress.reader.Analyze(bitmap);
        if (barcodes.Length > 0)
            results[path] = barcodes[0].BarcodeValue;
    }

    return results;
}

using Accusoft.BarcodeXpressSdk;
using System.Collections.Generic;
using System.Drawing;

public Dictionary<string, string> ProcessBatch(IEnumerable<string> imagePaths)
{
    var results = new Dictionary<string, string>();

    foreach (var path in imagePaths)
    {
        using var bitmap = new Bitmap(path);

        _barcodeXpress.reader.BarcodeTypes = new[]
        {
            BarcodeType.Code128Barcode,
            BarcodeType.QRCodeBarcode
        };

        var barcodes = _barcodeXpress.reader.Analyze(bitmap);
        if (barcodes.Length > 0)
            results[path] = barcodes[0].BarcodeValue;
    }

    return results;
}

Imports Accusoft.BarcodeXpressSdk
Imports System.Collections.Generic
Imports System.Drawing

Public Function ProcessBatch(imagePaths As IEnumerable(Of String)) As Dictionary(Of String, String)
    Dim results As New Dictionary(Of String, String)()

    For Each path In imagePaths
        Using bitmap As New Bitmap(path)
            _barcodeXpress.reader.BarcodeTypes = New BarcodeType() {
                BarcodeType.Code128Barcode,
                BarcodeType.QRCodeBarcode
            }

            Dim barcodes = _barcodeXpress.reader.Analyze(bitmap)
            If barcodes.Length > 0 Then
                results(path) = barcodes(0).BarcodeValue
            End If
        End Using
    Next

    Return results
End Function

The Standard Edition also enforces a 40-page-per-minute ceiling. A batch of 100,000 documents at 40 PPM takes roughly 41 hours to complete. The Professional Edition removes this cap but at a higher per-developer cost — in addition to the runtime licenses already purchased.

IronBarcode Approach

using IronBarCode;
using System.Collections.Concurrent;
using System.Threading.Tasks;

// IronBarcode — parallel batch with thread-safe static API
var files = Directory.GetFiles("/incoming/scans", "*.png");
var allResults = new ConcurrentBag<string>();

Parallel.ForEach(files, file =>
{
    var r = BarcodeReader.Read(file);
    foreach (var barcode in r)
        allResults.Add($"{file}: {barcode.Value}");
});

using IronBarCode;
using System.Collections.Concurrent;
using System.Threading.Tasks;

// IronBarcode — parallel batch with thread-safe static API
var files = Directory.GetFiles("/incoming/scans", "*.png");
var allResults = new ConcurrentBag<string>();

Parallel.ForEach(files, file =>
{
    var r = BarcodeReader.Read(file);
    foreach (var barcode in r)
        allResults.Add($"{file}: {barcode.Value}");
});

Imports IronBarCode
Imports System.Collections.Concurrent
Imports System.Threading.Tasks

' IronBarcode — parallel batch with thread-safe static API
Dim files = Directory.GetFiles("/incoming/scans", "*.png")
Dim allResults = New ConcurrentBag(Of String)()

Parallel.ForEach(files, Sub(file)
    Dim r = BarcodeReader.Read(file)
    For Each barcode In r
        allResults.Add($"{file}: {barcode.Value}")
    Next
End Sub)

Because IronBarcode's static methods are stateless, Parallel.ForEach over them is safe with no instance isolation required. IronBarcode imposes no throughput ceiling at any pricing tier. For tuning read performance, the BarcodeReaderOptions class provides ReadingSpeed and MaxParallelThreads settings:

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

var results = BarcodeReader.Read("warehouse-scan.png", options);

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

var results = BarcodeReader.Read("warehouse-scan.png", options);

Imports IronBarCode

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .MaxParallelThreads = 4
}

Dim results = BarcodeReader.Read("warehouse-scan.png", options)

ReadingSpeed.Balanced is the default. Use ReadingSpeed.Faster for high-throughput pipelines where the barcodes are clean, or ReadingSpeed.Detailed for damaged or low-contrast images.

Scaling Beyond the 40 PPM Wall

The Standard Edition limit of 40 pages per minute sounds generous until a business team decides to run end-of-day batch processing on a year's worth of archived invoices. A batch of 100,000 documents at that rate takes roughly 41 hours to complete. Moving to the Professional Edition removes the cap but at a higher per-developer seat cost — on top of runtime licenses already purchased. Teams that discover the throughput ceiling after signing a purchase order often find that the total cost of removing it substantially exceeds initial estimates.

CI/CD Pipeline Licensing Complexity

A typical CI/CD setup runs builds in ephemeral containers. With BarcodeXpress, every build environment needs both the SDK key pair and the runtime unlock keys available, managed as separate secrets. If the runtime key is missing or misconfigured, the build may succeed but integration tests return obscured values — a silent failure mode that is easy to miss in a test pipeline if test assertions are not carefully written against the actual barcode content.

Air-Gapped and Secure Deployment Requirements

Some environments — healthcare systems processing patient records, government document workflows, financial institution back-office processing — cannot have license validation making outbound network calls. BarcodeXpress's runtime license system involves Accusoft's licensing infrastructure, which may be a compliance concern in environments with strict network egress restrictions. Teams operating in those environments often choose libraries whose license validation is entirely local.

Docker and Container Deployment

BarcodeXpress in Docker typically requires either mounting a license file into the container at a known path or configuring a license server and pointing the container at it. Both approaches add deployment complexity — license files need to be distributed and kept in sync, and a license server is an additional piece of infrastructure to maintain. Teams moving to microservice architectures or serverless deployment patterns find that the configuration-file approach does not translate cleanly into immutable container images.

Evaluation Accuracy Requirements

Teams that need to validate read accuracy on their own documents before committing to a purchase find BarcodeXpress's evaluation mode fundamentally limiting. Testing against real-world document scans — checking whether the library handles low-contrast barcodes, skewed images, or multi-barcode pages — requires complete decoded values. Partially obscured output reveals only that the library found a barcode, not whether it read it correctly.

Instance Management to Static Calls

BarcodeXpress requires a BarcodeXpress instance to be created and licensed before any operation. IronBarcode's static methods need no instance. Teams migrating typically have a BarcodeService class whose constructor is largely licensing boilerplate — after migration, that constructor can be removed entirely or reduced to a single license key assignment.

BarcodeTypes Enumeration Removal

Every BarcodeXpress read operation requires a BarcodeTypes Array assignment to enumerate which symbologies to search for. IronBarcode auto-detects all supported formats by default. During migration, all reader.BarcodeTypes = ... assignments can be deleted without replacement. If there is a performance reason to restrict the search space, BarcodeReaderOptions supports format filtering as an explicit opt-in rather than a required default.

Result Property Name Changes

Two property renames affect all result-processing code: result.BarcodeValue becomes result.Value, and result.BarcodeType becomes result.Format. A solution-wide search-and-replace handles both. IronBarcode results also expose result.Confidence and result.PageNumber, which have no BarcodeXpress equivalent and can be used for additional filtering without code changes to existing result handling.

Docker License Configuration

BarcodeXpress Docker deployments typically use a mounted license configuration file. IronBarcode uses an environment variable. The migration involves removing the COPY instruction for the config file and adding a single environment variable assignment. In Kubernetes, the license key becomes a secret reference in the pod spec rather than a mounted volume.