Barcoder vs IronBarcode: C# BarCode Bibliothek Vergleich

Der Workflow zur Generierung mehrerer Pakete

Die Installationsgeschichte verdeutlicht unmittelbar den Unterschied im Umfang. Mit BarCodewerden für die grundlegende PNG-Ausgabe zwei separate Pakete benötigt:

dotnet add package Barcoder
dotnet add package Barcoder.Renderer.Image

dotnet add package Barcoder
dotnet add package Barcoder.Renderer.Image

Der vollständige Workflow zum Generieren eines Code128-Barcodes und zum Speichern als PNG erfordert drei Namespace-Importe, einen formatspezifischen Encoder-Aufruf, eine Renderer-Konstruktion mit einem Optionsobjekt, einen Dateistream und einen Render-Aufruf:

// Barcoder: 3 namespaces, 7 steps to save a PNG
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, 7 steps to save a PNG
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

Das Umschalten des Barcode-Formats ist keine Parameteränderung – es erfordert den Import eines anderen Namensraums und den Aufruf einer anderen Klasse. Code128Encoder.Encode erwartet einen booleschen Wert für includeChecksum, QrEncoder.Encode erwartet eine Fehlerkorrekturstufe und zwei zusätzliche boolesche Werte, und DataMatrixEncoder.Encode erwartet nur die Zeichenkette. Es gibt keine einheitliche Schnittstelle zum Erstellen eines Barcodes in einem bestimmten Format.

Detaillierter Funktionsvergleich

Barcoder-Ansatz

Barcoder leitet die Formatauswahl über separate Encoder-Klassen in separaten Namensräumen. Ein Formatwechsel bedeutet, eine neue using-Direktive hinzuzufügen und eine andere Klasse mit einer anderen Methodensignatur zu verwenden:

// Code128
using Barcoder.Code128;
IBarcode barcode = Code128Encoder.Encode("data", false);

// QR Code — different namespace, different class, different parameters
using Barcoder.Qr;
IBarcode barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, false, false);

// DataMatrix — different namespace, different class again
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

// Code128
using Barcoder.Code128;
IBarcode barcode = Code128Encoder.Encode("data", false);

// QR Code — different namespace, different class, different parameters
using Barcoder.Qr;
IBarcode barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, false, false);

// DataMatrix — different namespace, different class again
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

Imports Barcoder.Code128
Imports Barcoder.Qr
Imports Barcoder.DataMatrix

' Code128
Dim barcode As IBarcode = Code128Encoder.Encode("data", False)

' QR Code — different namespace, different class, different parameters
barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, False, False)

' DataMatrix — different namespace, different class again
barcode = DataMatrixEncoder.Encode("data")

Jeder Encoder hat seinen eigenen Parametervertrag. Das Hinzufügen eines neuen Formats zu einem bestehenden Projekt ist keine Ein-Wort-Änderung – es erfordert den Import eines neuen Namespace, das Erlernen einer neuen Klasse und das Verstehen neuer Parameter.

IronBarcode Ansatz

IronBarcode leitet die gesamte Formatauswahl über die BarcodeEncoding Enumeration der einheitlichen Klasse BarcodeWriter weiter. Das Hinzufügen eines neuen Formats besteht aus einer Änderung des Enum-Werts um ein einziges Wort:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png");

// DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png");

// QR with logo
QRCodeWriter.CreateQrCode("data", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png");

// DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png");

// QR with logo
QRCodeWriter.CreateQrCode("data", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

Imports IronBarCode

' Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png")

' DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png")

' QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png")

' QR with logo
QRCodeWriter.CreateQrCode("data", 500) _
    .AddBrandLogo("logo.png") _
    .SaveAsPng("qr-branded.png")

Für den Produktiveinsatz muss der Lizenzschlüssel beim Start der Anwendung hinzugefügt werden:

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

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

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-KEY"

Die IronBarcode Dokumentation zur Barcode-Generierung deckt das gesamte Spektrum der Generierungsoptionen ab, einschließlich Stil, Ränder und Farbanpassung.

Barcoder-Ansatz

Die Trennung von Kodierung und Darstellung bei BarCodeist zwar als Architekturprinzip begründet, führt aber bei jeder Änderung des Ausgabeformats zu Mehraufwand. Zum Speichern in einer Datei muss eine FileStream geöffnet werden. Um Binärdaten zu erhalten, muss ein MemoryStream geöffnet und ToArray() aufgerufen werden. Für jedes Ausgabeszenario ist die Erstellung eines Renderers mit einem Optionsobjekt erforderlich:

// Barcoder: changing output dimensions requires rebuilding the renderer
var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 3,
    BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode-large.png");
renderer.Render(barcode, stream);

// Getting binary data — different stream, same renderer pipeline
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

// Barcoder: changing output dimensions requires rebuilding the renderer
var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 3,
    BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode-large.png");
renderer.Render(barcode, stream);

// Getting binary data — different stream, same renderer pipeline
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

Imports System.IO

' Barcoder: changing output dimensions requires rebuilding the renderer
Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 3,
    .BarHeightFor1DBarcode = 80
})

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

' Getting binary data — different stream, same renderer pipeline
Using ms As New MemoryStream()
    renderer.Render(barcode, ms)
    Dim pngBytes As Byte() = ms.ToArray()
End Using

Die Größensteuerung erfolgt indirekt: PixelSize ist ein Skalierungsfaktor für die Größe des Barcode-Moduls und keine direkte Angabe von Breite und Höhe.

IronBarcode Ansatz

IronBarcode gibt ein GeneratedBarcode-Objekt zurück, von dem aus über verkettete Methodenaufrufe jede Ausgabeform erreicht werden kann. Keine Renderer-Konstruktion, kein Stream-Management:

using IronBarCode;

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

// File
barcode.SaveAsPng("barcode.png");

// Bytes
byte[] pngBytes = barcode.ToPngBinaryData();

// Stream
System.IO.Stream stream = barcode.ToStream();

using IronBarCode;

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

// File
barcode.SaveAsPng("barcode.png");

// Bytes
byte[] pngBytes = barcode.ToPngBinaryData();

// Stream
System.IO.Stream stream = barcode.ToStream();

Imports IronBarCode

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

' File
barcode.SaveAsPng("barcode.png")

' Bytes
Dim pngBytes As Byte() = barcode.ToPngBinaryData()

' Stream
Dim stream As System.IO.Stream = barcode.ToStream()

.ResizeTo(width, height) nimmt explizite Pixelabmessungen entgegen und kann mit jeder Ausgabemethode desselben Objekts verkettet werden.

Barcoder-Ansatz

Barcoder besitzt keine Lese- oder Dekodierungsfunktion. Es gibt keine API, keine geplante API und keine Umgehungslösung innerhalb der Bibliothek. Wenn eine Anwendung Barcodes lesen muss, muss neben BarCodeeine zweite Bibliothek hinzugefügt werden – eine separate NuGet Abhängigkeit mit eigener API-Oberfläche und eigener Versionsverwaltung. Das bedeutet mindestens zwei lesenahe Abhängigkeiten: BarCodefür die Generierung und etwas anderes zum Lesen.

IronBarcode Ansatz

IronBarcode deckt sowohl die Generierung als auch das Lesen mit demselben Paket und einheitlichen API-Mustern ab. Die Methode BarcodeReader.Read() akzeptiert Bilddateien, Byte-Arrays, Datenströme und PDFs nativ:

using IronBarCode;

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

// Aus PDF lesen — no conversion step, no extra dependency
var pdfResults = BarcodeReader.Read("document.pdf");

// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-label.png", options);

using IronBarCode;

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

// Aus PDF lesen — no conversion step, no extra dependency
var pdfResults = BarcodeReader.Read("document.pdf");

// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-label.png", options);

Imports IronBarCode

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

' Aus PDF lesen — no conversion step, no extra dependency
Dim pdfResults = BarcodeReader.Read("document.pdf")

' Read multiple barcodes from one image
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim multiResults = BarcodeReader.Read("warehouse-label.png", options)

Das Einlesen von PDFs erfolgt nativ – es ist keine Zwischenabfrage der Bildextraktion, keine Konvertierungsbibliothek und kein zusätzliches Paket erforderlich. Die IronBarcode Dokumentation zum Barcode-Lesen behandelt mehrseitige PDFs, das Lesen von Bereichen von Interesse und die Leistungsoptimierung.

Lesen wird als zusätzliche Anforderung gefordert

Viele Projekte beginnen als reine Generierungspipelines – Etiketten drucken, Codes für Dokumente generieren, Barcodes in Berichte einbetten. BarCodeunterstützt diese Projekte von Anfang an. Wenn dieselbe Anwendung später eingehende Barcodes überprüfen, gescannte Dokumente verarbeiten oder Barcodes aus hochgeladenen PDFs dekodieren muss, bietet BarCodekeine Lösung. Das Team muss eine zweite Bibliothek evaluieren, deren API erlernen, deren NuGet Version separat verwalten und die Integrationsschnittstelle zwischen den beiden Bibliotheken handhaben. Teams, die diesen Punkt erreichen, greifen häufig auf eine Bibliothek zurück, die beide Seiten abdeckt, anstatt zwei separate Barcode-Abhängigkeiten zu pflegen.

Der Kompatibilitätsbruch des .NET Framework

Barcoder.Renderer.Image hat die Unterstützung für .NET Frameworkeingestellt. Teams, die Dienste oder Desktop-Anwendungen auf Basis des .NET Framework4.x pflegen und das Image-Renderer-Paket im Rahmen der routinemäßigen Abhängigkeitswartung aktualisieren, stoßen auf einen Build-Fehler. Dies ist keine Fehlkonfiguration – es handelt sich um eine Entscheidung der Bibliothek zur Plattformunterstützung. IronBarcode unterstützt .NET Framework4.6.2 bis .NET 9ohne spezielle Paketierung oder bedingte Abhängigkeiten für verschiedene Zielplattformen.

Versionsabweichungen bei Paketen verursachen Koordinationsprobleme

Da Barcoder und Barcoder.Renderer.Image unabhängig versioniert sind, kann eine Aktualisierung der einen Version ohne die andere während einer Abhängigkeitsaktualisierung zu subtilen Inkompatibilitäten führen. In einem Repository mit mehreren Projekten – von denen jedes eine andere Version jedes Renderer-Pakets verwendet – wird die Gewährleistung eines einheitlichen Verhaltens über alle Projekte hinweg zu einem Koordinationsproblem, das mit der Größe des Teams zunimmt. Teams, die auf IronBarcode umsteigen, berichten, dass die Verwaltung eines einzigen Pakets und einer einzigen Version diese Problemkategorie vollständig beseitigt.

Die Formatabdeckung erweitert sich im Laufe der Zeit

Ein Projekt könnte mit Code128-Etiketten beginnen und später QR-Codes für kundenorientierte Links hinzufügen, dann DataMatrix für die Einhaltung von Vorschriften. Bei BarCodebedeutet jede Formaterweiterung einen neuen Namespace-Import, eine andere Encoder-Klasse mit anderen Methodenparametern und möglicherweise ein neues NuGet Paket. Bei IronBarcode entspricht das Hinzufügen eines Formats einer Änderung des Enum-Werts BarcodeEncoding in einem bestehenden Aufruf. Teams, deren Roadmap die Erweiterung der Barcode-Formatabdeckung vorsieht, finden das auf Enumerationen basierende Modell deutlich einfacher zu pflegen.

MAUI- und plattformübergreifende Bereitstellungsanforderungen

Barcoder dokumentiert keine Unterstützung für MAUI-, Docker-, AWS Lambda- oder Azure-Bereitstellungen. Teams, die plattformübergreifende MAUI-Anwendungen entwickeln oder die Barcode-Verarbeitung auf serverloser Infrastruktur implementieren, stellen fest, dass die Dokumentation und die Tests von BarCodediese Ziele nicht abdecken. IronBarcode dokumentiert und testet aktiv den Einsatz auf iOS-, Android-, Windows-, macOS MAUI-Zielen, Docker-Containern und wichtigen Cloud-Plattformen.

Die Typänderung von IBarcode zu GeneratedBarcode

Der Barcoder-Code, der eine IBarcode Variable speichert und diese später an einen Renderer übergibt, muss refaktoriert werden. In IronBarcode verfügt GeneratedBarcode über eigene Ausgabemethoden – es gibt keinen separaten Renderer-Schritt. Jede Methodensignatur, die derzeit IBarcode akzeptiert, sollte so geändert werden, dass sie GeneratedBarcode akzeptiert, und der Rendering-Aufruf innerhalb dieser Methode sollte ein direkter Aufruf wie .SaveAsPng() oder .ToPngBinaryData() werden. Das Typsystem zeigt während der Kompilierung jede Stelle an, die aktualisiert werden muss — IBarcode wird nach dem Entfernen der Barcoder-Pakete nicht mehr aufgelöst.

PixelSize Hat kein direktes Äquivalent

Barcoders PixelSize ist ein Skalierungsfaktor für die natürliche Modulgröße des Barcodes und keine explizite Pixeldimension. Die Ausgabebreite hängt vom Barcode-Inhalt, dem Format und dem Multiplikator in Kombination ab. IronBarcode verwendet .ResizeTo(width, height)mit expliziten Pixelabmessungen. Messen Sie während der Migration die tatsächlichen Ausgabedimensionen, die der vorhandene Barcoder-Code erzeugt, und verwenden Sie diese Werte im Aufruf .ResizeTo():

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")

Namensraumkonsolidierung

Barcoder-Projekte sammeln using Barcoder.*-Anweisungen – eine pro verwendetem Format. Während der Migration werden all diese zu einem einzigen using IronBarCode; zusammengefasst. Eine Suche nach using Barcoder in der gesamten Lösung identifiziert alle Dateien, die aktualisiert werden müssen. Die Anzahl der betroffenen Dateien ist in der Regel größer als von den Teams erwartet, da jede Datei, die ein Barcode-Format verwendet, ihren eigenen formatspezifischen Namensraum importiert.

Änderungen des SVG-Ausgabepfads

Projekte, die die Klassen Barcoder.Renderer.Svg und SvgRenderer verwenden, ersetzen die Renderer-Pipeline durch einen direkten Methodenaufruf auf GeneratedBarcode:

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

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

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

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

Imports System.IO

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

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

Das Paket Barcoder.Renderer.Svg kann entfernt werden, sobald alle SVG-Rendering-Websites migriert wurden.