Accusoft BarcodeXpress vs IronBarcode: C# Barcode Library Comparison

The Two-Key System Explained

BarcodeXpress splits licensing into two conceptually separate layers:

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

var barcodeXpress = new BarcodeXpress();
// Step 1: SDK license (for development)
barcodeXpress.Licensing.SolutionName = "YourCompanyName";
barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
// Step 2: Runtime license (for production — minimum 5 purchased)
barcodeXpress.Licensing.UnlockRuntime("YourRuntimeKey", Convert.ToInt64("98765432109876"));

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

var barcodeXpress = new BarcodeXpress();
// Step 1: SDK license (for development)
barcodeXpress.Licensing.SolutionName = "YourCompanyName";
barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
// Step 2: Runtime license (for production — minimum 5 purchased)
barcodeXpress.Licensing.UnlockRuntime("YourRuntimeKey", Convert.ToInt64("98765432109876"));

Imports Accusoft.BarcodeXpressSdk

Dim barcodeXpress As New BarcodeXpress()
' Step 1: SDK license (for development)
barcodeXpress.Licensing.SolutionName = "YourCompanyName"
barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234")
' Step 2: Runtime license (for production — minimum 5 purchased)
barcodeXpress.Licensing.UnlockRuntime("YourRuntimeKey", Convert.ToInt64("98765432109876"))

The SolutionName and SolutionKey pair activates the SDK itself. The UnlockRuntime call, which takes its own key and its own solution key as separate arguments, activates production deployment capabilities. Both must be present and valid for a production deployment to return complete, unobscured barcode values.

In code review, this pattern produces a predictable question: "Why are we calling UnlockRuntime with two different keys?" 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.

The IsRuntimeUnlocked property lets you check whether the runtime layer is active:

if (!barcodeXpress.Licensing.IsRuntimeUnlocked)
{
    // In this state, barcode values are partially obscured
    // "1234567890" returns as "1234...XXX"
    Console.WriteLine("Warning: runtime license not active");
}

if (!barcodeXpress.Licensing.IsRuntimeUnlocked)
{
    // In this state, barcode values are partially obscured
    // "1234567890" returns as "1234...XXX"
    Console.WriteLine("Warning: runtime license not active");
}

If Not barcodeXpress.Licensing.IsRuntimeUnlocked Then
    ' In this state, barcode values are partially obscured
    ' "1234567890" returns as "1234...XXX"
    Console.WriteLine("Warning: runtime license not active")
End If

This check is the guard teams add when they realize that evaluation-mode output silently returns partial data rather than throwing an exception or clearly failing.

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.SolutionName = "AcmeCorp";
        _barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");

        // Layer 2: Runtime license — separate purchase, minimum 5
        _barcodeXpress.Licensing.UnlockRuntime(
            "RuntimeKey-XXXXXX",
            Convert.ToInt64("98765432109876"));

        // Guard against partial-value mode
        if (!_barcodeXpress.Licensing.IsRuntimeUnlocked)
        {
            throw new InvalidOperationException(
                "Runtime license not active — barcode values will be obscured");
        }
    }
}

using Accusoft.BarcodeXpressSdk;

public class BarcodeService
{
    private readonly BarcodeXpress _barcodeXpress;

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

        // Layer 1: SDK license
        _barcodeXpress.Licensing.SolutionName = "AcmeCorp";
        _barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");

        // Layer 2: Runtime license — separate purchase, minimum 5
        _barcodeXpress.Licensing.UnlockRuntime(
            "RuntimeKey-XXXXXX",
            Convert.ToInt64("98765432109876"));

        // Guard against partial-value mode
        if (!_barcodeXpress.Licensing.IsRuntimeUnlocked)
        {
            throw new InvalidOperationException(
                "Runtime license not active — barcode values will be obscured");
        }
    }
}

Imports Accusoft.BarcodeXpressSdk

Public Class BarcodeService
    Private ReadOnly _barcodeXpress As BarcodeXpress

    Public Sub New()
        _barcodeXpress = New BarcodeXpress()

        ' Layer 1: SDK license
        _barcodeXpress.Licensing.SolutionName = "AcmeCorp"
        _barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234")

        ' Layer 2: Runtime license — separate purchase, minimum 5
        _barcodeXpress.Licensing.UnlockRuntime("RuntimeKey-XXXXXX", Convert.ToInt64("98765432109876"))

        ' Guard against partial-value mode
        If Not _barcodeXpress.Licensing.IsRuntimeUnlocked Then
            Throw New InvalidOperationException("Runtime license not active — barcode values will be obscured")
        End If
    End Sub
End Class

This is a 15-line constructor that exists entirely to manage two separate license key systems before any barcode operation can take place. The IsRuntimeUnlocked guard is not optional — without it, the service will silently return degraded values in any environment where the runtime key is missing or misconfigured.

IronBarcode Approach

using IronBarCode;

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

using IronBarCode;

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

Imports IronBarCode

' In Program.vb or startup configuration
IronBarCode.License.LicenseKey = "YOUR-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 involves configuring the reader via SetPropertyValue, which takes a constant and a value, then calling Analyze() to retrieve results:

using Accusoft.BarcodeXpressSdk;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var barcodeXpress = new BarcodeXpress();
    barcodeXpress.Licensing.SolutionName = "AcmeCorp";
    barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
    barcodeXpress.Licensing.UnlockRuntime("RuntimeKey", Convert.ToInt64("98765432109876"));

    barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, imagePath);
    barcodeXpress.reader.BarcodeTypes =
        BarcodeType.LinearBarcode |
        BarcodeType.DataMatrixBarcode |
        BarcodeType.QRCodeBarcode;

    var results = barcodeXpress.reader.Analyze();
    return results.Select(r => r.BarcodeValue);
}

using Accusoft.BarcodeXpressSdk;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var barcodeXpress = new BarcodeXpress();
    barcodeXpress.Licensing.SolutionName = "AcmeCorp";
    barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
    barcodeXpress.Licensing.UnlockRuntime("RuntimeKey", Convert.ToInt64("98765432109876"));

    barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, imagePath);
    barcodeXpress.reader.BarcodeTypes =
        BarcodeType.LinearBarcode |
        BarcodeType.DataMatrixBarcode |
        BarcodeType.QRCodeBarcode;

    var results = barcodeXpress.reader.Analyze();
    return results.Select(r => r.BarcodeValue);
}

Imports Accusoft.BarcodeXpressSdk

Public Function ReadAllBarcodes(imagePath As String) As IEnumerable(Of String)
    Dim barcodeXpress = New BarcodeXpress()
    barcodeXpress.Licensing.SolutionName = "AcmeCorp"
    barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234")
    barcodeXpress.Licensing.UnlockRuntime("RuntimeKey", Convert.ToInt64("98765432109876"))

    barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, imagePath)
    barcodeXpress.reader.BarcodeTypes = BarcodeType.LinearBarcode Or BarcodeType.DataMatrixBarcode Or BarcodeType.QRCodeBarcode

    Dim results = barcodeXpress.reader.Analyze()
    Return results.Select(Function(r) r.BarcodeValue)
End Function

The cycBxeSetFilename constant is the API's way of specifying the file to process. This pattern — passing a constant identifier plus a value to a generic SetPropertyValue method — is reminiscent of older COM-based APIs. If a document contains a format not listed in BarcodeTypes, it will not be found. This becomes maintenance overhead when document sources change.

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;

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

    foreach (var path in imagePaths)
    {
        _barcodeXpress.reader.SetPropertyValue(
            BarcodeXpress.cycBxeSetFilename, path);
        _barcodeXpress.reader.BarcodeTypes =
            BarcodeType.LinearBarcode | BarcodeType.QRCodeBarcode;

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

    return results;
}

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

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

    foreach (var path in imagePaths)
    {
        _barcodeXpress.reader.SetPropertyValue(
            BarcodeXpress.cycBxeSetFilename, path);
        _barcodeXpress.reader.BarcodeTypes =
            BarcodeType.LinearBarcode | BarcodeType.QRCodeBarcode;

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

    return results;
}

Imports Accusoft.BarcodeXpressSdk
Imports System.Collections.Generic

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
        _barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, path)
        _barcodeXpress.reader.BarcodeTypes = BarcodeType.LinearBarcode Or BarcodeType.QRCodeBarcode

        Dim barcodes = _barcodeXpress.reader.Analyze()
        If barcodes.Length > 0 Then
            results(path) = barcodes(0).BarcodeValue
        End If
    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 flag 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.