QRCoder.NET vs IronBarcode: C# BarCode Bibliothek Vergleich

Das QR-Code-Design

QRCoder trennt die Datenerzeugung vom Rendering. Ein QRCodeGenerator erzeugt ein QRCodeData Zwischenobjekt, das dann an eine Rendererklasse übergeben wird. Dieses Muster ermöglicht eine präzise Kontrolle über das Ausgabeformat, erfordert jedoch zusätzliche Objekte:

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

// PNG bytes via PngByteQRCode
var pngQR = new PngByteQRCode(qrCodeData);
byte[] pngBytes = pngQR.GetGraphic(20); // 20px per module
File.WriteAllBytes("qr.png", pngBytes);

// SVG string via SvgQRCode
string svgContent = new SvgQRCode(qrCodeData).GetGraphic(10);
File.WriteAllText("qr.svg", svgContent);

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

// PNG bytes via PngByteQRCode
var pngQR = new PngByteQRCode(qrCodeData);
byte[] pngBytes = pngQR.GetGraphic(20); // 20px per module
File.WriteAllBytes("qr.png", pngBytes);

// SVG string via SvgQRCode
string svgContent = new SvgQRCode(qrCodeData).GetGraphic(10);
File.WriteAllText("qr.svg", svgContent);

Imports QRCoder
Imports System.IO

Dim qrGenerator As New QRCodeGenerator()
Dim qrCodeData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M)

' PNG bytes via PngByteQRCode
Dim pngQR As New PngByteQRCode(qrCodeData)
Dim pngBytes As Byte() = pngQR.GetGraphic(20) ' 20px per module
File.WriteAllBytes("qr.png", pngBytes)

' SVG string via SvgQRCode
Dim svgContent As String = New SvgQRCode(qrCodeData).GetGraphic(10)
File.WriteAllText("qr.svg", svgContent)

Die Methode QRCodeGenerator.CreateQrCode ist der einzige Einstiegspunkt für die Codeerstellung – es gibt keine CreateCode128, keine CreateDataMatrix, keine CreateEAN13. Die Bibliothek hält sich voll und ganz an ihren vorgesehenen Zweck.

Detaillierter Funktionsvergleich

QRCoder-Ansatz

QRCoder verwendet ein zweiphasiges Muster: QRCodeGenerator.CreateQrCode erzeugt ein QRCodeData Zwischenobjekt, das die Daten und den Fehlerkorrekturgrad kodiert, und eine separate Renderer-Klasse konvertiert dieses Zwischenobjekt in das gewünschte Ausgabeformat. Der ECC-Level ist ein erforderlicher Parameter ohne Standardwert – Entwickler müssen ihn explizit auswählen:

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

var qrCode = new PngByteQRCode(qrCodeData);
byte[] pngBytes = qrCode.GetGraphic(20); // pixels per module
File.WriteAllBytes("qr.png", pngBytes);

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

var qrCode = new PngByteQRCode(qrCodeData);
byte[] pngBytes = qrCode.GetGraphic(20); // pixels per module
File.WriteAllBytes("qr.png", pngBytes);

Imports QRCoder
Imports System.IO

Dim qrGenerator As New QRCodeGenerator()
Dim qrCodeData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M)

Dim qrCode As New PngByteQRCode(qrCodeData)
Dim pngBytes As Byte() = qrCode.GetGraphic(20) ' pixels per module
File.WriteAllBytes("qr.png", pngBytes)

Dieses Muster hat den Vorteil, dass das qrCodeData-Objekt für mehrere Ausgabeformate wiederverwendet werden kann, ohne die Codedaten neu zu generieren. Zu den Renderer-Klassen gehören unter anderem PngByteQRCode, SvgQRCode, AsciiQRCode, Base64QRCode und BitmapByteQRCode.

IronBarcode Ansatz

IronBarcode fasst Generierung und Rendering zu einer flüssigen Kette in der statischen Klasse BarcodeWriter zusammen. Der Parameter BarcodeEncoding.QRCode wählt das Format aus, und Terminalmethoden wie SaveAsPng oder ToPngBinaryData bestimmen die Ausgabe:

using IronBarCode;

// Single fluent call — no intermediate objects
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .ResizeTo(400, 400)
    .SaveAsPng("qr.png");

using IronBarCode;

// Single fluent call — no intermediate objects
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .ResizeTo(400, 400)
    .SaveAsPng("qr.png");

Imports IronBarCode

' Single fluent call — no intermediate objects
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .ResizeTo(400, 400) _
    .SaveAsPng("qr.png")

Für Fälle, die eine explizite Fehlerkorrektur erfordern, bietet die Klasse QRCodeWriter formatspezifische Optionen:

using IronBarCode;

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

using IronBarCode;

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

Imports IronBarCode

Dim qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium)
qr.SaveAsPng("qr.png")

Der IronBarcode 2D-Barcode-Erstellungsleitfaden deckt alle unterstützten 2D-Formate ab, einschließlich QR-Code, DataMatrix, PDF417und Aztec, und verwendet dafür denselben Einstiegspunkt BarcodeWriter.

QRCoder-Ansatz

Die Einbettung des QRCoder-Logos erfolgt über die Renderer-Klasse QRCode (die sich von PngByteQRCode unterscheidet), welche eine GetGraphic-Überladung bereitstellt, die eine System.Drawing.Bitmap-Überladung akzeptiert. Das bedeutet, dass der aufrufende Code direkt mit System.Drawing arbeiten muss, um die Logodatei zu laden:

using QRCoder;
using System.Drawing;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.H // High ECC required when logo occludes part of the code
);

var qrCode = new QRCode(qrCodeData);
var logoBitmap = new Bitmap("logo.png");
var qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap);
qrBitmap.Save("qr-logo.png", System.Drawing.Imaging.ImageFormat.Png);

using QRCoder;
using System.Drawing;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.H // High ECC required when logo occludes part of the code
);

var qrCode = new QRCode(qrCodeData);
var logoBitmap = new Bitmap("logo.png");
var qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap);
qrBitmap.Save("qr-logo.png", System.Drawing.Imaging.ImageFormat.Png);

Imports QRCoder
Imports System.Drawing

Dim qrGenerator As New QRCodeGenerator()
Dim qrCodeData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.H) ' High ECC required when logo occludes part of the code

Dim qrCode As New QRCode(qrCodeData)
Dim logoBitmap As New Bitmap("logo.png")
Dim qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap)
qrBitmap.Save("qr-logo.png", System.Drawing.Imaging.ImageFormat.Png)

Die Farbanpassung folgt einem ähnlichen Muster über die Parameter GetGraphic der Überladung darkColor und lightColor.

IronBarcode Ansatz

IronBarcode stellt das Einbetten von Logos und Farbänderungen als benannte Methoden im QRCodeWriter Ergebnisobjekt bereit. Die Methode AddBrandLogo akzeptiert einen Dateipfad, und ChangeBarCodeColor akzeptiert einen Color Wert:

using IronBarCode;
using System.Drawing;

// Logo embedding
var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Highest
);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-logo.png");

// Colour customisation
var coloredQr = QRCodeWriter.CreateQrCode("https://example.com", 500);
coloredQr.ChangeBarCodeColor(Color.DarkBlue);
coloredQr.SaveAsPng("colored-qr.png");

using IronBarCode;
using System.Drawing;

// Logo embedding
var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Highest
);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-logo.png");

// Colour customisation
var coloredQr = QRCodeWriter.CreateQrCode("https://example.com", 500);
coloredQr.ChangeBarCodeColor(Color.DarkBlue);
coloredQr.SaveAsPng("colored-qr.png");

Imports IronBarCode
Imports System.Drawing

' Logo embedding
Dim qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
qr.AddBrandLogo("logo.png")
qr.SaveAsPng("qr-logo.png")

' Colour customisation
Dim coloredQr = QRCodeWriter.CreateQrCode("https://example.com", 500)
coloredQr.ChangeBarCodeColor(Color.DarkBlue)
coloredQr.SaveAsPng("colored-qr.png")

Der Leitfaden zur Anpassung des QR-Code-Stils behandelt Logogröße, Farbkombinationen und die Steuerung von Ruhezonen im Detail.

QRCoder-Ansatz

QRCoder besitzt keine API zum Lesen von Barcodes. Die Klasse QRCodeGenerator und alle Renderer-Klassen dienen ausschließlich der Generierung. Es gibt keine Methode, einen QR-Code aus einem Bild, einer Datei oder einem Datenstrom zu dekodieren. Anwendungen, die sowohl QR-Codes generieren als auch lesen müssen, benötigen eine separate Bibliothek – typischerweise ZXing .NET – mit eigener API, eigenem Namensraum und eigenem Wartungszyklus:

// QR-Code has no reading API.
// These methods do not exist:
//   qrGenerator.Decode("image.png");
//   QRCodeReader.Read("image.png");
//
// A separate library (e.g., ZXing.Net) is required for decoding.

// QR-Code has no reading API.
// These methods do not exist:
//   qrGenerator.Decode("image.png");
//   QRCodeReader.Read("image.png");
//
// A separate library (e.g., ZXing.Net) is required for decoding.

' QR-Code has no reading API.
' These methods do not exist:
'   qrGenerator.Decode("image.png")
'   QRCodeReader.Read("image.png")
'
' A separate library (e.g., ZXing.Net) is required for decoding.

Dies ist eine bewusste Designentscheidung, kein Versehen – QR-Code ist explizit eine Generierungsbibliothek.

IronBarcode Ansatz

IronBarcode beinhaltet eine Lese-API im selben Paket. BarcodeReader.Read akzeptiert Bilddateien, PDF-Dateien, Streams und System.Drawing.Bitmap Objekte. Es erkennt Barcode-Formate automatisch, ohne dass der Aufrufer das zu suchende Format angeben muss, und gibt alle im Bild gefundenen Barcodes zurück:

using IronBarCode;

// Reading a QR code — no separate library required
var results = BarcodeReader.Read("qr.png");
foreach (var result in results)
{
    Console.WriteLine(result.Text);        // decoded value
    Console.WriteLine(result.BarcodeType); // QRCode, Code128, EAN13, etc.
}

using IronBarCode;

// Reading a QR code — no separate library required
var results = BarcodeReader.Read("qr.png");
foreach (var result in results)
{
    Console.WriteLine(result.Text);        // decoded value
    Console.WriteLine(result.BarcodeType); // QRCode, Code128, EAN13, etc.
}

Imports IronBarCode

' Reading a QR code — no separate library required
Dim results = BarcodeReader.Read("qr.png")
For Each result In results
    Console.WriteLine(result.Text)        ' decoded value
    Console.WriteLine(result.BarcodeType) ' QRCode, Code128, EAN13, etc.
Next

Der Leitfaden zum Lesen von Barcodes aus Bildern umfasst das Lesen aus PDFs, mehrseitigen Dokumenten, Datenströmen sowie niedrig auflösenden oder verrauschten Bildern über denselben Eingabepunkt.

QRCoder-Ansatz

QRCoder generiert ausschließlich QR-Codes – dies ist so beabsichtigt. Die Methode QRCodeGenerator.CreateQrCode ist der einzige Einstiegspunkt für die Generierung, den die Bibliothek bereitstellt. Projekte, die mit QR-Codes beginnen und später Code-128-Versandetiketten, EAN-13-Produktcodes oder DataMatrix-Konformitätscodes für Arzneimittel benötigen, müssen eine zweite Bibliothek einführen, um jedes zusätzliche Format abzudecken:

using QRCoder;

// QR-Code is limited to QR — other formats require separate packages
var qrGenerator = new QRCodeGenerator();
var qr = qrGenerator.CreateQrCode("scan-to-track", QRCodeGenerator.ECCLevel.M);

// Code 128requires a different library (e.g., NetBarcode)
// DataMatrixrequires yet another library
// Reading any format requires yet another library

using QRCoder;

// QR-Code is limited to QR — other formats require separate packages
var qrGenerator = new QRCodeGenerator();
var qr = qrGenerator.CreateQrCode("scan-to-track", QRCodeGenerator.ECCLevel.M);

// Code 128requires a different library (e.g., NetBarcode)
// DataMatrixrequires yet another library
// Reading any format requires yet another library

Imports QRCoder

' QR-Code is limited to QR — other formats require separate packages
Dim qrGenerator As New QRCodeGenerator()
Dim qr = qrGenerator.CreateQrCode("scan-to-track", QRCodeGenerator.ECCLevel.M)

' Code 128 requires a different library (e.g., NetBarcode)
' DataMatrix requires yet another library
' Reading any format requires yet another library

IronBarcode Ansatz

IronBarcode deckt alle Formatfamilien über denselben Einstiegspunkt BarcodeWriter.CreateBarcode ab. Der Wechsel von QR-Code zu Code 128zu DataMatrixerfordert lediglich die Änderung des Parameters BarcodeEncoding – keine zusätzlichen Pakete, keine neuen Namensräume, keine separaten APIs:

using IronBarCode;

// All formats — one API, one package
BarcodeWriter.CreateBarcode("scan-to-track", BarcodeEncoding.QRCode)
    .SaveAsPng("campaign-qr.png");

BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product-code.png");

BarcodeWriter.CreateBarcode("LOT-ABC-123", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-code.png");

using IronBarCode;

// All formats — one API, one package
BarcodeWriter.CreateBarcode("scan-to-track", BarcodeEncoding.QRCode)
    .SaveAsPng("campaign-qr.png");

BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product-code.png");

BarcodeWriter.CreateBarcode("LOT-ABC-123", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-code.png");

Imports IronBarCode

' All formats — one API, one package
BarcodeWriter.CreateBarcode("scan-to-track", BarcodeEncoding.QRCode) _
    .SaveAsPng("campaign-qr.png")

BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128) _
    .SaveAsPng("shipping-label.png")

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13) _
    .SaveAsPng("product-code.png")

BarcodeWriter.CreateBarcode("LOT-ABC-123", BarcodeEncoding.DataMatrix) _
    .SaveAsPng("pharma-code.png")

Formatanforderungen gehen über QR hinaus

Die meisten Barcode-Anforderungen beginnen mit QR-Codes, und QR-Code deckt diesen ersten Bereich zuverlässig ab. Die Spannung entsteht, wenn ein zweites Format ins Spiel kommt. Logistikteams, die Code-128-Etiketten für den Versand benötigen, Einzelhandelsbetriebe, die EAN-13-Produktcodes erfordern, pharmazeutische Arbeitsabläufe, die DataMatrixfür die Serialisierung vorschreiben – jedes neue Format drängt ein Team dazu, eine weitere NuGet Abhängigkeit hinzuzufügen. Die Integrationskosten jeder zusätzlichen Bibliothek umfassen einen neuen Namespace, der erlernt werden muss, einen neuen Release-Zyklus, der überwacht werden muss, und eine neue potenzielle Fehlerquelle bei Versionskonflikten bei .NET Upgrades.

Barcode-Lesen wird notwendig

Eine Anwendung, die ausgehende QR-Codes für eine Kampagne generiert, ist ein reines Generierungssystem. Eine Anwendung, die auch eingehende Sendungen verarbeitet, Produktcodes bei Ankunft überprüft oder Tickets bei einer Veranstaltung validiert, ist ein Generierungs- und Lesesystem. QR-Code verfügt konstruktionsbedingt über keine Lesefunktion – diese Lücke muss durch eine zweite Bibliothek geschlossen werden. Die Einführung einer Lesebibliothek verändert den Integrationsaufwand des Barcode-Subsystems erheblich, insbesondere wenn die Lesebibliothek eigene Formatvorgaben oder Thread-Sicherheitsbeschränkungen mit sich bringt.

Wartungsaufwand für mehrere Bibliotheken

Das natürliche Akkumulationsmuster für ein auf QR-Code basierendes Projekt folgt einem vorhersehbaren Pfad: QR-Code zur QR-Generierung, eine 1D-Barcode-Bibliothek für Versandetiketten, eine Lesebibliothek zum Dekodieren. Jede Bibliothek verfügt über eine eigene Dokumentation, einen eigenen Versionszyklus und eine eigene Historie von grundlegenden Änderungen. Ein .NET Versions-Upgrade, das für eine Bibliothek nur geringfügig ist, kann mit einer grundlegenden Änderung in einer anderen Bibliothek zusammenfallen. Teams, die diese Kostenakkumulation über Jahre hinweg verwalten, berichten, dass die versteckten Kosten nicht in der anfänglichen Integration liegen, sondern im sich summierenden Wartungsaufwand über mehrere Upgrade-Zyklen hinweg.

PDF-Dokumentunterstützung

Mit QR-Code ist es nicht möglich, Barcodes zu generieren, die in PDF-Berichte eingebettet werden können, oder Barcodes aus eingehenden PDF-Dokumenten in einer Dokumentenverarbeitungspipeline zu extrahieren. Für die Unterstützung von PDFs ist entweder eine vollständige PDF-Bibliothek mit Barcode-Funktionen oder eine spezielle Kombination von Bibliotheken erforderlich. Teams, die dokumentenzentrierte Arbeitsabläufe erstellen – Rechnungsverarbeitung, Compliance-Berichterstattung, Etikettengenerierung aus PDF-Vorlagen – stellen fest, dass sich der Anwendungsbereich von QR-Code bereits früh im Projektlebenszyklus mit den PDF-Anforderungen überschneidet.

PayloadGenerator-Zeichenfolgenformat

Die Hilfsklassen von QR-Code (PayloadGenerator) erzeugen Zeichenketten, die den öffentlichen QR-Code-Payload-Standards entsprechen. Das WiFi-Format erzeugt beispielsweise WIFI:T:WPA;S:NetworkName;P:Password;;. Diese Zeichenketten können direkt in IronBarcode ohne Hilfsklasse erstellt werden, da das Format ein öffentlicher Standard ist, der in der QR-Code-Spezifikation dokumentiert ist. Teams, die häufig PayloadGenerator verwenden, sollten planen, kleine statische Hilfsmethoden zu schreiben, die die String-Konstruktion nachbilden.

ECCLevel-Enum-Zuordnung

QRCoder verwendet QRCodeGenerator.ECCLevel mit den Werten L, M, Q, H. IronBarcode verwendet QRCodeWriter.QrErrorCorrectionLevel mit den Werten Low, Medium, Quartile und Highest. Die Zuordnung ist direkt, aber die Enum-Referenzen müssen an allen Aufrufstellen aktualisiert werden. Wo QR-Code bei jedem CreateQrCode-Aufruf eine explizite ECC-Auswahl erforderte, wendet IronBarcode einen sinnvollen Standardwert an, wenn der Pfad BarcodeWriter.CreateBarcode verwendet wird.

Entfernung der Renderer-Klasse

Die Rendererklassen von QR-Code — PngByteQRCode, SvgQRCode, AsciiQRCode, Base64QRCode, QRCode — werden nach der Migration überflüssig. IronBarcode integriert das Rendering in die Fluent Chain auf GeneratedBarcode, sodass das Muster des Zwischenrendererobjekts nicht übernommen wird. Code, der diese Rendererklassen instanziiert, kann durch Terminalmethodenaufrufe auf dem BarcodeWriter Ergebnis ersetzt werden.