MIGRATION GUIDES

Migrating from Barcoder to IronBarcode

Updated:May 3, 2026

This guide covers the complete migration path from Barcoder to IronBarcode for .NET developers. The migration consolidates two packages into one, replaces the encoder-renderer pipeline with a single method call, and collapses all format-specific namespace imports — using Barcoder.Code128, using Barcoder.Qr, using Barcoder.DataMatrix — into a single using IronBarCode;. The IBarcode type and the ImageRenderer / ImageRendererOptions types are removed entirely. If reading was a missing capability that caused you to add a second library alongside Barcoder, IronBarcode covers reading natively with BarcodeReader.Read().

Why Migrate from Barcoder

Teams migrating from Barcoder report these triggers:

Reading Requirement Added: Barcoder is a generation-only library with no decoding capability. When an application needs to verify incoming barcodes, process scanned documents, or read barcodes from uploaded PDFs, Barcoder provides no path forward. Adding a second library for reading creates a split codebase with two NuGet dependencies, two APIs to maintain, and two version histories to track. IronBarcode handles both generation and reading through the same package.

.NET Framework Compatibility Broken: Barcoder.Renderer.Image dropped .NET Framework support. Teams running services or desktop applications on .NET Framework 4.x who update the image renderer package during routine dependency maintenance encounter a build failure. IronBarcode supports .NET Framework 4.6.2 through .NET 9 without conditional packaging for different targets.

Package Version Drift: Barcoder and Barcoder.Renderer.Image are independently versioned NuGet packages. Updating one without the other during a dependency refresh can introduce incompatibilities. In repositories with multiple projects, ensuring consistent versions of each renderer across every project is a coordination burden that grows with team size.

Multiple Formats Being Added: A project that starts with Code128 and later adds QR, then DataMatrix, must add a new namespace import and learn a different encoder class with different method parameters for each format. IronBarcode uses a BarcodeEncoding enum — adding a format is a one-word change to an existing call. No new namespace, no new class, no different method signature.

MAUI and Cloud Deployment Requirements: Barcoder does not document support for MAUI, Docker, AWS Lambda, or Azure deployments. Teams building cross-platform mobile applications or serverless barcode processing pipelines find that Barcoder's documented targets do not cover these scenarios.

The Fundamental Problem

Barcoder couples format selection to namespace imports and forces a renderer pipeline for every output operation. Switching formats or output types requires structural changes to the code:

// Barcoder: 3 namespaces, encoder-specific class, renderer pipeline, stream management
using Barcoder;
using Barcoder.Code128;
using Barcoder.Renderers;

IBarcode barcode = Code128Encoder.Encode("PRODUCT-12345", false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 2,
    BarHeightFor1DBarcode = 50
});

using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);

// Barcoder: 3 namespaces, encoder-specific class, renderer pipeline, stream management
using Barcoder;
using Barcoder.Code128;
using Barcoder.Renderers;

IBarcode barcode = Code128Encoder.Encode("PRODUCT-12345", false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 2,
    BarHeightFor1DBarcode = 50
});

using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);

Imports Barcoder
Imports Barcoder.Code128
Imports Barcoder.Renderers
Imports System.IO

Dim barcode As IBarcode = Code128Encoder.Encode("PRODUCT-12345", False)

Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 2,
    .BarHeightFor1DBarcode = 50
})

Using stream As FileStream = File.OpenWrite("barcode.png")
    renderer.Render(barcode, stream)
End Using

$vbLabelText $csharpLabel

IronBarcode expresses the same operation as a single chained call:

// IronBarcode: 1 namespace, 1 method, 1 output call
using IronBarCode;

BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// IronBarcode: 1 namespace, 1 method, 1 output call
using IronBarCode;

BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128) _
    .SaveAsPng("barcode.png")

$vbLabelText $csharpLabel

IronBarcode vs Barcoder: Feature Comparison

Feature	Barcoder	IronBarcode
NuGet packages required	2 minimum (Barcoder + Barcoder.Renderer.Image)	1 (IronBarcode)
Barcode generation	Yes	Yes
Barcode reading / decoding	No	Yes
Per-format encoder classes	Yes — `Code128Encoder`, `QrEncoder`, `DataMatrixEncoder`, etc.	No — `BarcodeEncoding` enum
Per-format namespace imports	Yes — `Barcoder.Code128`, `Barcoder.Qr`, `Barcoder.DataMatrix`	No — `using IronBarCode` only
Output methods on result object	No — `IBarcode` has no save methods	Yes — `GeneratedBarcode` has `SaveAsPng`, `ToPngBinaryData`, `ToStream`
PDF reading	No	Yes — `BarcodeReader.Read(path)`
QR with logo	No	Yes — `.AddBrandLogo(path)`
.NET Framework support	Dropped in image renderer	.NET Framework 4.6.2+
.NET 9 support	Unclear / limited activity	Yes
MAUI support	No	Yes — iOS, Android, Windows, macOS
Docker / Azure / AWS Lambda	Not documented	Yes
License	MIT (open source)	Commercial — Lite $749, Plus $1,499, Professional $2,999, Unlimited $5,999
ReadingSpeed control	No	Yes — `ReadingSpeed` enum
Multi-barcode detection	No	Yes — `ExpectMultipleBarcodes` option

Quick Start: Barcoder to IronBarcode Migration

Step 1: Replace NuGet Package

Remove all Barcoder packages from your project:

dotnet remove package Barcoder
dotnet remove package Barcoder.Renderer.Image

dotnet remove package Barcoder
dotnet remove package Barcoder.Renderer.Image

SHELL

If you also added the SVG renderer:

dotnet remove package Barcoder.Renderer.Svg

dotnet remove package Barcoder.Renderer.Svg

SHELL

Install IronBarcode:

dotnet add package IronBarcode

dotnet add package IronBarcode

SHELL

Step 2: Update Namespaces

Remove all using Barcoder.* statements from every file in the project:

// Remove all of these
using Barcoder;
using Barcoder.Code128;
using Barcoder.Qr;
using Barcoder.DataMatrix;
using Barcoder.Renderers;
using Barcoder.Ean;
using Barcoder.Pdf417;
// ... and any other Barcoder.* namespaces in your project

// Remove all of these
using Barcoder;
using Barcoder.Code128;
using Barcoder.Qr;
using Barcoder.DataMatrix;
using Barcoder.Renderers;
using Barcoder.Ean;
using Barcoder.Pdf417;
// ... and any other Barcoder.* namespaces in your project

$vbLabelText $csharpLabel

Replace all of them with a single using directive:

using IronBarCode;

using IronBarCode;

Imports IronBarCode

$vbLabelText $csharpLabel

Step 3: Initialize License

Add license initialization at application startup — Program.cs, Startup.cs, or MauiProgram.cs:

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

$vbLabelText $csharpLabel

A free trial key is available at ironsoftware.com.

Code Migration Examples

Code128 Generation

Barcoder Approach:

using Barcoder;
using Barcoder.Code128;
using Barcoder.Renderers;

IBarcode barcode = Code128Encoder.Encode("PRODUCT-12345", false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 2,
    BarHeightFor1DBarcode = 50
});

using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);

using Barcoder;
using Barcoder.Code128;
using Barcoder.Renderers;

IBarcode barcode = Code128Encoder.Encode("PRODUCT-12345", false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 2,
    BarHeightFor1DBarcode = 50
});

using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);

Imports Barcoder
Imports Barcoder.Code128
Imports Barcoder.Renderers
Imports System.IO

Dim barcode As IBarcode = Code128Encoder.Encode("PRODUCT-12345", False)

Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 2,
    .BarHeightFor1DBarcode = 50
})

Using stream As FileStream = File.OpenWrite("barcode.png")
    renderer.Render(barcode, stream)
End Using

$vbLabelText $csharpLabel

IronBarcode Approach:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// NuGet: dotnet add package IronBarcode
using IronBarCode;

BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128) _
    .SaveAsPng("barcode.png")

$vbLabelText $csharpLabel

The Code128Encoder, ImageRenderer, ImageRendererOptions, and stream management are removed entirely. The format is specified as BarcodeEncoding.Code128 on the unified BarcodeWriter class. Output methods live directly on the returned GeneratedBarcode object. The IronBarcode barcode generation documentation covers styling, margin, and color customization.

QR Code Generation

Barcoder Approach:

using Barcoder;
using Barcoder.Qr;
using Barcoder.Renderers;

IBarcode barcode = QrEncoder.Encode("https://example.com", ErrorCorrectionLevel.M, false, false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 4
});

using var stream = File.OpenWrite("qr.png");
renderer.Render(barcode, stream);

using Barcoder;
using Barcoder.Qr;
using Barcoder.Renderers;

IBarcode barcode = QrEncoder.Encode("https://example.com", ErrorCorrectionLevel.M, false, false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 4
});

using var stream = File.OpenWrite("qr.png");
renderer.Render(barcode, stream);

Imports Barcoder
Imports Barcoder.Qr
Imports Barcoder.Renderers
Imports System.IO

Dim barcode As IBarcode = QrEncoder.Encode("https://example.com", ErrorCorrectionLevel.M, False, False)

Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 4
})

Using stream As FileStream = File.OpenWrite("qr.png")
    renderer.Render(barcode, stream)
End Using

$vbLabelText $csharpLabel

IronBarcode Approach:

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com", 500)
    .SaveAsPng("qr.png");

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com", 500)
    .SaveAsPng("qr.png");

Imports IronBarCode

QRCodeWriter.CreateQrCode("https://example.com", 500) _
    .SaveAsPng("qr.png")

$vbLabelText $csharpLabel

The second parameter to CreateQrCode is the output dimension in pixels. Error correction level defaults to a sensible value and is configurable if needed. IronBarcode also supports an operation not possible in Barcoder — embedding a brand logo in the QR code center:

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

Imports IronBarCode

QRCodeWriter.CreateQrCode("https://example.com", 500) _
    .AddBrandLogo("logo.png") _
    .SaveAsPng("qr-branded.png")

$vbLabelText $csharpLabel

DataMatrix Generation

Barcoder Approach:

using Barcoder;
using Barcoder.DataMatrix;
using Barcoder.Renderers;

IBarcode barcode = DataMatrixEncoder.Encode("ITEM-XYZ-001");

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 5
});

using var stream = File.OpenWrite("datamatrix.png");
renderer.Render(barcode, stream);

using Barcoder;
using Barcoder.DataMatrix;
using Barcoder.Renderers;

IBarcode barcode = DataMatrixEncoder.Encode("ITEM-XYZ-001");

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 5
});

using var stream = File.OpenWrite("datamatrix.png");
renderer.Render(barcode, stream);

Imports Barcoder
Imports Barcoder.DataMatrix
Imports Barcoder.Renderers
Imports System.IO

Dim barcode As IBarcode = DataMatrixEncoder.Encode("ITEM-XYZ-001")

Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 5
})

Using stream As FileStream = File.OpenWrite("datamatrix.png")
    renderer.Render(barcode, stream)
End Using

$vbLabelText $csharpLabel

IronBarcode Approach:

using IronBarCode;

BarcodeWriter.CreateBarcode("ITEM-XYZ-001", BarcodeEncoding.DataMatrix)
    .SaveAsPng("datamatrix.png");

using IronBarCode;

BarcodeWriter.CreateBarcode("ITEM-XYZ-001", BarcodeEncoding.DataMatrix)
    .SaveAsPng("datamatrix.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("ITEM-XYZ-001", BarcodeEncoding.DataMatrix) _
    .SaveAsPng("datamatrix.png")

$vbLabelText $csharpLabel

The pattern is identical to Code128 — only the BarcodeEncoding value changes. No new namespace import, no different class, no different method signature.

Controlling Output Size

Barcoder uses PixelSize as a scale multiplier on the barcode module size and BarHeightFor1DBarcode for 1D height — there is no direct width/height API.

Barcoder Approach:

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 3,
    BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 3,
    BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);

Imports System.IO

Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 3,
    .BarHeightFor1DBarcode = 80
})

Using stream As FileStream = File.OpenWrite("barcode.png")
    renderer.Render(barcode, stream)
End Using

$vbLabelText $csharpLabel

IronBarcode Approach:

using IronBarCode;

BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

using IronBarCode;

BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("barcode.png")

$vbLabelText $csharpLabel

.ResizeTo(width, height) takes explicit pixel dimensions. It chains with other output methods on the same GeneratedBarcode object.

Getting Binary Data Instead of a File

Barcoder Approach:

using Barcoder;
using Barcoder.Code128;
using Barcoder.Renderers;

IBarcode barcode = Code128Encoder.Encode("PRODUCT-12345", false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 2
});

using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

using Barcoder;
using Barcoder.Code128;
using Barcoder.Renderers;

IBarcode barcode = Code128Encoder.Encode("PRODUCT-12345", false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 2
});

using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

Imports Barcoder
Imports Barcoder.Code128
Imports Barcoder.Renderers
Imports System.IO

Dim barcode As IBarcode = Code128Encoder.Encode("PRODUCT-12345", False)

Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 2
})

Using ms As New MemoryStream()
    renderer.Render(barcode, ms)
    Dim pngBytes As Byte() = ms.ToArray()
End Using

$vbLabelText $csharpLabel

IronBarcode Approach:

using IronBarCode;

byte[] pngBytes = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ToPngBinaryData();

using IronBarCode;

byte[] pngBytes = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ToPngBinaryData();

Imports IronBarCode

Dim pngBytes As Byte() = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128).ToPngBinaryData()

$vbLabelText $csharpLabel

The MemoryStream and ToArray() pattern is replaced by a single chained method call on GeneratedBarcode.

Reading Barcodes (Net-New Capability)

Barcoder has no reading API. If you previously added a second library for reading, it can be removed. IronBarcode reads from files, byte arrays, streams, and PDFs with the same package used for generation.

IronBarcode Approach:

using IronBarCode;

// Read from image file
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
{
    Console.WriteLine($"Value: {result.Value}");
    Console.WriteLine($"Format: {result.Format}");
}

// Read from PDF natively — no image extraction step, no extra dependency
var pdfResults = BarcodeReader.Read("invoice.pdf");

// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-sheet.png", options);
foreach (var result in multiResults)
    Console.WriteLine(result.Value);

// Read from a stream directly
using var fileStream = File.OpenRead("barcode.png");
var streamResults = BarcodeReader.Read(fileStream);

using IronBarCode;

// Read from image file
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
{
    Console.WriteLine($"Value: {result.Value}");
    Console.WriteLine($"Format: {result.Format}");
}

// Read from PDF natively — no image extraction step, no extra dependency
var pdfResults = BarcodeReader.Read("invoice.pdf");

// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-sheet.png", options);
foreach (var result in multiResults)
    Console.WriteLine(result.Value);

// Read from a stream directly
using var fileStream = File.OpenRead("barcode.png");
var streamResults = BarcodeReader.Read(fileStream);

Imports IronBarCode

' Read from image file
Dim results = BarcodeReader.Read("barcode.png")
For Each result In results
    Console.WriteLine($"Value: {result.Value}")
    Console.WriteLine($"Format: {result.Format}")
Next

' Read from PDF natively — no image extraction step, no extra dependency
Dim pdfResults = BarcodeReader.Read("invoice.pdf")

' Read multiple barcodes from one image
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim multiResults = BarcodeReader.Read("warehouse-sheet.png", options)
For Each result In multiResults
    Console.WriteLine(result.Value)
Next

' Read from a stream directly
Using fileStream = File.OpenRead("barcode.png")
    Dim streamResults = BarcodeReader.Read(fileStream)
End Using

$vbLabelText $csharpLabel

The IronBarcode barcode reading documentation covers multi-page PDFs, region-of-interest reading, and performance tuning options.

SVG Output

Barcoder Approach:

using Barcoder.Renderers;
var svgRenderer = new SvgRenderer();
using var stream = File.OpenWrite("barcode.svg");
svgRenderer.Render(barcode, stream);

using Barcoder.Renderers;
var svgRenderer = new SvgRenderer();
using var stream = File.OpenWrite("barcode.svg");
svgRenderer.Render(barcode, stream);

Imports Barcoder.Renderers

Dim svgRenderer = New SvgRenderer()
Using stream = File.OpenWrite("barcode.svg")
    svgRenderer.Render(barcode, stream)
End Using

$vbLabelText $csharpLabel

IronBarcode Approach:

using IronBarCode;

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .SaveAsSvg("barcode.svg");

using IronBarCode;

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .SaveAsSvg("barcode.svg");

Imports IronBarCode

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
    .SaveAsSvg("barcode.svg")

$vbLabelText $csharpLabel

The Barcoder.Renderer.Svg package can be removed once all SVG rendering sites are migrated.

Barcoder API to IronBarcode Mapping Reference

Barcoder	IronBarcode
`Code128Encoder.Encode("data", false)`	`BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)`
`QrEncoder.Encode("data", ErrorCorrectionLevel.M, false, false)`	`QRCodeWriter.CreateQrCode("data", 500)`
`DataMatrixEncoder.Encode("data")`	`BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix)`
`new ImageRenderer(new ImageRendererOptions { ... })`	Not needed
`renderer.Render(barcode, fileStream)`	`.SaveAsPng(path)`
`renderer.Render(barcode, memoryStream)` + `ms.ToArray()`	`.ToPngBinaryData()`
`IBarcode`	`GeneratedBarcode`
`PixelSize = 2, BarHeightFor1DBarcode = 50`	`.ResizeTo(width, height)`
`SvgRenderer` + `renderer.Render(barcode, stream)`	`.SaveAsSvg(path)`
No reading API	`BarcodeReader.Read(path / stream / bytes / pdf)`
2 packages — `Barcoder` + `Barcoder.Renderer.Image`	1 package — `IronBarcode`
Format namespace per encoder (`Barcoder.Code128`, `Barcoder.Qr`, etc.)	`BarcodeEncoding` enum, single namespace

Common Migration Issues and Solutions

Issue 1: IBarcode Has No Save Methods

Barcoder: Code that stores an IBarcode variable and passes it to a renderer later follows a deferred rendering pattern. Any helper method that accepts IBarcode and calls renderer.Render() must be refactored.

Solution: Change IBarcode type references to GeneratedBarcode. The GeneratedBarcode object carries its output methods with it — pass it to any method that needs to save or serialize the result:

// IronBarcode — GeneratedBarcode carries output methods
using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128);
SaveBarcodeToFile(barcode, "output.png");

static void SaveBarcodeToFile(GeneratedBarcode barcode, string path)
{
    barcode.SaveAsPng(path);
}

// IronBarcode — GeneratedBarcode carries output methods
using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128);
SaveBarcodeToFile(barcode, "output.png");

static void SaveBarcodeToFile(GeneratedBarcode barcode, string path)
{
    barcode.SaveAsPng(path);
}

Imports IronBarCode

Dim barcode = BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
SaveBarcodeToFile(barcode, "output.png")

Private Sub SaveBarcodeToFile(barcode As GeneratedBarcode, path As String)
    barcode.SaveAsPng(path)
End Sub

$vbLabelText $csharpLabel

A search for renderer.Render( across the solution will locate all deferred rendering sites.

Issue 2: PixelSize Has No Direct Equivalent

Barcoder: PixelSize is a scale multiplier on the barcode's natural module size. The output dimensions depend on content length, format, and the multiplier in combination. BarHeightFor1DBarcode controls 1D height independently. There is no direct width/height specification.

Solution: Measure the actual pixel output that existing Barcoder code produces and pass those values to .ResizeTo(width, height):

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .ResizeTo(300, 80)
    .SaveAsPng("barcode.png");

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .ResizeTo(300, 80)
    .SaveAsPng("barcode.png");

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
    .ResizeTo(300, 80) _
    .SaveAsPng("barcode.png")

$vbLabelText $csharpLabel

Issue 3: Format Namespace Imports Accumulate

Barcoder: Each barcode format used in a project adds a using Barcoder.[Format] directive to each file that uses it. A project using Code128, QR, and DataMatrix typically has three format-specific imports per file plus using Barcoder and using Barcoder.Renderers.

Solution: Run a search for all using Barcoder statements and replace all of them with using IronBarCode;:

grep -rn "using Barcoder" --include="*.cs" .

grep -rn "using Barcoder" --include="*.cs" .

SHELL

Every result is a line to remove, replaced by the single using IronBarCode; directive once per file.

Issue 4: Package Version Sync Errors

Barcoder: Building after updating only one of Barcoder or Barcoder.Renderer.Image can produce type-resolution errors because the two packages may not be compatible at different version combinations.

Solution: After removing both Barcoder packages and installing IronBarcode, there is one package and one version. Package lock conflicts in this category are eliminated. Verify the .csproj file contains only the single IronBarcode reference and no remaining Barcoder.* references before building.

Barcoder Migration Checklist

Pre-Migration Tasks

Audit your codebase to identify all Barcoder usage before making changes:

grep -rn "using Barcoder" --include="*.cs" .
grep -rn "Code128Encoder\.Encode" --include="*.cs" .
grep -rn "QrEncoder\.Encode" --include="*.cs" .
grep -rn "DataMatrixEncoder\.Encode" --include="*.cs" .
grep -rn "ImageRenderer\|ImageRendererOptions" --include="*.cs" .
grep -rn "SvgRenderer" --include="*.cs" .
grep -rn "renderer\.Render(" --include="*.cs" .
grep -rn "IBarcode" --include="*.cs" .
grep -rn "ErrorCorrectionLevel" --include="*.cs" .

grep -rn "using Barcoder" --include="*.cs" .
grep -rn "Code128Encoder\.Encode" --include="*.cs" .
grep -rn "QrEncoder\.Encode" --include="*.cs" .
grep -rn "DataMatrixEncoder\.Encode" --include="*.cs" .
grep -rn "ImageRenderer\|ImageRendererOptions" --include="*.cs" .
grep -rn "SvgRenderer" --include="*.cs" .
grep -rn "renderer\.Render(" --include="*.cs" .
grep -rn "IBarcode" --include="*.cs" .
grep -rn "ErrorCorrectionLevel" --include="*.cs" .

SHELL

Document all locations where IBarcode is stored as a variable type or passed as a method parameter — these are the deferred rendering sites that require the most attention. Note all PixelSize and BarHeightFor1DBarcode values and measure the corresponding output dimensions.

Code Update Tasks

Remove Barcoder NuGet package from all projects
Remove Barcoder.Renderer.Image NuGet package from all projects
Remove Barcoder.Renderer.Svg NuGet package if present
Install IronBarcode NuGet package
Add IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"; at application startup
Replace all using Barcoder.* statements with using IronBarCode;
Replace Code128Encoder.Encode(...) with BarcodeWriter.CreateBarcode(..., BarcodeEncoding.Code128)
Replace QrEncoder.Encode(...) with QRCodeWriter.CreateQrCode(..., size)
Replace DataMatrixEncoder.Encode(...) with BarcodeWriter.CreateBarcode(..., BarcodeEncoding.DataMatrix)
Remove all new ImageRenderer(new ImageRendererOptions {...}) constructions
Replace renderer.Render(barcode, fileStream) with .SaveAsPng(path) on GeneratedBarcode
Replace renderer.Render(barcode, memoryStream) + ms.ToArray() with .ToPngBinaryData()
Replace SvgRenderer usage with .SaveAsSvg(path)
Change IBarcode type references to GeneratedBarcode
Replace PixelSize / BarHeightFor1DBarcode options with .ResizeTo(width, height)

Post-Migration Testing

Verify each generated barcode format scans correctly with a standard scanner or IronBarcode's own reader
Compare visual output dimensions to pre-migration output — confirm .ResizeTo() values produce equivalent sizes
Test QR code output against a phone scanner to confirm error correction level is adequate
Verify SVG output renders correctly in browser and print contexts if your project uses SVG
If you removed a second reading library, verify BarcodeReader.Read() produces equivalent decoded values for the same inputs
Test PDF reading if your project processes PDF documents — confirm multi-page PDFs read all pages correctly
Run a build with zero Barcoder.* references remaining — compiler errors indicate missed migration sites

Key Benefits of Migrating to IronBarcode

Unified Package Dependency: One NuGet package replaces two (or three, if the SVG renderer was also used). One version to track, one changelog to monitor, and no cross-package compatibility issues during dependency updates. The .csproj and packages.lock.json complexity decreases immediately.

Native Reading Capability: Applications that previously required a second library for barcode reading can consolidate onto IronBarcode. BarcodeReader.Read() accepts image files, byte arrays, streams, and PDFs through the same API, with multi-barcode detection and reading speed tuning built in.

Format Selection as Configuration: Adding a new barcode format to an existing project is a one-word change to the BarcodeEncoding enum value in an existing CreateBarcode call. No new namespace import, no new encoder class, and no new package. This makes format expansion low-friction as product requirements evolve.

Explicit Output Dimensions: .ResizeTo(width, height) replaces the indirect PixelSize multiplier system with an explicit pixel specification. The relationship between code and output is direct and predictable, independent of barcode content length or format-specific module sizing.

Expanded Platform Coverage: IronBarcode supports .NET Framework 4.6.2 through .NET 9, MAUI deployments on iOS, Android, Windows, and macOS, and documented deployment to Docker, AWS Lambda, and Azure Functions. Teams whose platform requirements expand beyond .NET Core will not encounter the framework support gap that affects Barcoder.Renderer.Image.

Active Maintenance and Future Compatibility: IronBarcode releases regular updates with documented .NET compatibility timelines. The active release cadence keeps the library aligned with current .NET versions, which is not assured from a library with limited recent release activity.

Frequently Asked Questions

Why should I migrate from Barcoder to IronBarcode?

Common reasons include simplifying licensing (removing SDK + runtime key complexity), eliminating throughput limits, gaining native PDF support, improving Docker/CI/CD deployment, and reducing API boilerplate in production code.

How do I replace Barcoder API calls with IronBarcode?

Replace instance creation and licensing boilerplate with IronBarCode.License.LicenseKey = "key". Replace reader calls with BarcodeReader.Read(path) and writer calls with BarcodeWriter.CreateBarcode(data, encoding). Static methods require no instance management.

How much code changes when migrating from Barcoder to IronBarcode?

Most migrations result in fewer lines of code. Licensing boilerplate, instance constructors, and explicit format configuration are removed. Core read/write operations map to shorter IronBarcode equivalents with cleaner result objects.

Do I need to keep both Barcoder and IronBarcode installed during migration?

No. Most migrations are direct replacements rather than parallel operation. Migrate one service class at a time, replace the NuGet reference, and update the instantiation and API call patterns before moving to the next class.

What is the NuGet package name for IronBarcode?

The package is 'IronBarCode' (with capital B and C). Install it with 'Install-Package IronBarCode' or 'dotnet add package IronBarCode'. The using directive in code is 'using IronBarCode;'.

How does IronBarcode simplify Docker deployment compared to Barcoder?

IronBarcode is a NuGet package with no external SDK files or mounted license configuration. In Docker, set the IRONBARCODE_LICENSE_KEY environment variable and the package handles license validation at startup.

Does IronBarcode detect all barcode formats automatically after migrating from Barcoder?

Yes. IronBarcode auto-detects symbology across all supported formats. Explicit BarcodeTypes enumeration is not required. If format is already known and performance matters, BarcodeReaderOptions allows restricting the search space as an optimization.

Can IronBarcode read barcodes from PDFs without a separate library?

Yes. BarcodeReader.Read("document.pdf") processes PDF files natively. Results include PageNumber, Format, Value, and Confidence for each barcode found. No external PDF rendering step is required.

How does IronBarcode handle parallel barcode processing?

IronBarcode's static methods are stateless and thread-safe. Use Parallel.ForEach directly over file lists without per-thread instance management. BarcodeReaderOptions.MaxParallelThreads controls the internal thread budget.

What result properties change when migrating from Barcoder to IronBarcode?

Common renames: BarcodeValue becomes Value, BarcodeType becomes Format. IronBarcode results also add Confidence and PageNumber. A solution-wide search-and-replace handles the renames in existing result-processing code.

How do I set up IronBarcode licensing in a CI/CD pipeline?

Store IRONBARCODE_LICENSE_KEY as a pipeline secret and assign IronBarCode.License.LicenseKey in application startup code. One secret covers all environments including development, test, staging, and production.

Does IronBarcode support QR code generation with custom styling?

Yes. QRCodeWriter.CreateQrCode() supports custom colors via ChangeBarCodeColor(), logo embedding via AddBrandLogo(), configurable error correction levels, and multiple output formats including PNG, JPG, PDF, and stream.

Jordi Bardia

Chat with engineering team now

Software Engineer

Jordi is most proficient in Python, C# and C++, when he isn’t leveraging his skills at Iron Software; he’s game programming. Sharing responsibilities for product testing, product development and research, Jordi adds immense value to continual product improvement. The varied experience keeps him challenged and engaged, and he ...

Updated May 3, 2026

Porting Barcode Logic from Google ML Kit to IronBarcode in .NET

This guide is for teams in one of two situations: you are porting an Android application to .NET MAUI or .NET 9 and.

Published May 3, 2026

Migrating from Dynamsoft Barcode Reader to IronBarcode

Most developers who migrate from Dynamsoft to IronBarcode fall into one of two groups: those who chose Dynamsoft for.

Published May 2, 2026

Migrating from DevExpress Barcode Controls to IronBarcode

If you are using DevExpress for its grid, chart, scheduler, or pivot controls, keep those. This migration is.

Migrating from BarcodeScanning.Native.Maui to IronBarcode

Migrating from BarcodeLib to IronBarcode

Start Free 30 Day Trial

Migrating from Barcoder to IronBarcode

Why Migrate from Barcoder

The Fundamental Problem

IronBarcode vs Barcoder: Feature Comparison

Quick Start: Barcoder to IronBarcode Migration

Step 1: Replace NuGet Package

Step 2: Update Namespaces

Step 3: Initialize License

Code Migration Examples

Code128 Generation

QR Code Generation

DataMatrix Generation

Controlling Output Size

Getting Binary Data Instead of a File

Reading Barcodes (Net-New Capability)

SVG Output

Barcoder API to IronBarcode Mapping Reference

Common Migration Issues and Solutions

Issue 1: IBarcode Has No Save Methods

Issue 2: PixelSize Has No Direct Equivalent

Issue 3: Format Namespace Imports Accumulate

Issue 4: Package Version Sync Errors

Barcoder Migration Checklist

Pre-Migration Tasks

Code Update Tasks

Post-Migration Testing

Key Benefits of Migrating to IronBarcode

Frequently Asked Questions

Why should I migrate from Barcoder to IronBarcode?

How do I replace Barcoder API calls with IronBarcode?

How much code changes when migrating from Barcoder to IronBarcode?

Do I need to keep both Barcoder and IronBarcode installed during migration?

What is the NuGet package name for IronBarcode?

How does IronBarcode simplify Docker deployment compared to Barcoder?

Does IronBarcode detect all barcode formats automatically after migrating from Barcoder?

Can IronBarcode read barcodes from PDFs without a separate library?

How does IronBarcode handle parallel barcode processing?

What result properties change when migrating from Barcoder to IronBarcode?

How do I set up IronBarcode licensing in a CI/CD pipeline?

Does IronBarcode support QR code generation with custom styling?

Related Articles

Porting Barcode Logic from Google ML Kit to IronBarcode in .NET

Migrating from Dynamsoft Barcode Reader to IronBarcode

Migrating from DevExpress Barcode Controls to IronBarcode

Next step: Start free 30-day Trial

Thank You

Next step: Start free 30-day Trial

Want to deploy IronSuite to a live project for FREE?

What’s included?

Trusted by Millions of Engineers Worldwide

Iron Support Team