NetBarcode gegen IronBarcode: C# Barcode Bibliothek Vergleich

Die Entwurfsgrenze des Typ-Enums

Die Aufzählung Type ist die maßgebliche Liste dessen, was NetBarcodegenerieren kann. Eine genauere Betrachtung offenbart den Umfang der Bibliothek:

// NetBarcodeType enum — complete list as of v1.8
public enum Type
{
    Code128,
    Code128A,
    Code128B,
    Code128C,
    Code39,
    Code39Extended,
    Code93,
    EAN8,
    EAN13,
    UPCA,
    UPCE,
    Codabar,
    ITF,
    MSI
}

// These entries do not exist — attempting to use them produces a CS0117 compile error:
// Type.QRCode      — does not exist
// Type.DataMatrix  — does not exist
// Type.PDF417      — does not exist
// Type.Aztec       — does not exist

// NetBarcodeType enum — complete list as of v1.8
public enum Type
{
    Code128,
    Code128A,
    Code128B,
    Code128C,
    Code39,
    Code39Extended,
    Code93,
    EAN8,
    EAN13,
    UPCA,
    UPCE,
    Codabar,
    ITF,
    MSI
}

// These entries do not exist — attempting to use them produces a CS0117 compile error:
// Type.QRCode      — does not exist
// Type.DataMatrix  — does not exist
// Type.PDF417      — does not exist
// Type.Aztec       — does not exist

Public Enum Type
    Code128
    Code128A
    Code128B
    Code128C
    Code39
    Code39Extended
    Code93
    EAN8
    EAN13
    UPCA
    UPCE
    Codabar
    ITF
    MSI
End Enum

' These entries do not exist — attempting to use them produces a BC30456 compile error:
' Type.QRCode      — does not exist
' Type.DataMatrix  — does not exist
' Type.PDF417      — does not exist
' Type.Aztec       — does not exist

Dies ist kein fehlendes Feature, für das ein Pull Request aussteht. Die Enumeration hat vierzehn Einträge, alle eindimensional, und das spiegelt den beabsichtigten Umfang der Bibliothek wider. Für alle Anwendungen, die QR-Codes, DataMatrix, PDF417oder aztekisch benötigen, muss ein separates Paket zur Bereitstellung dieser Formate erworben werden.

Detaillierter Funktionsvergleich

NetBarcode-Ansatz

NetBarcode bietet 14 lineare Barcode-Formate über das Type Enum an. Innerhalb dieses Rahmens ist die Formatauswahl unkompliziert – man übergibt dem Konstruktor das entsprechende Enum-Element. Die Grenze ist ebenso klar: Der Versuch, ein Format außerhalb des Enums zu verwenden, führt zu einem Kompilierfehler.

// NetBarcode— formats that compile and produce output
using NetBarcode;

var code128 = new Barcode("12345678901234", Type.Code128);
code128.SaveImageFile("shipping.png");

var ean13 = new Barcode("5901234123457", Type.EAN13);
ean13.SaveImageFile("product.png");

// NetBarcode— formats that produce CS0117 compile errors
// var qr     = new Barcode("data", Type.QRCode);     // error CS0117
// var dm     = new Barcode("data", Type.DataMatrix);  // error CS0117
// var p417   = new Barcode("data", Type.PDF417);      // error CS0117
// var aztec  = new Barcode("data", Type.Aztec);       // error CS0117

// NetBarcode— formats that compile and produce output
using NetBarcode;

var code128 = new Barcode("12345678901234", Type.Code128);
code128.SaveImageFile("shipping.png");

var ean13 = new Barcode("5901234123457", Type.EAN13);
ean13.SaveImageFile("product.png");

// NetBarcode— formats that produce CS0117 compile errors
// var qr     = new Barcode("data", Type.QRCode);     // error CS0117
// var dm     = new Barcode("data", Type.DataMatrix);  // error CS0117
// var p417   = new Barcode("data", Type.PDF417);      // error CS0117
// var aztec  = new Barcode("data", Type.Aztec);       // error CS0117

Imports NetBarcode

Dim code128 As New Barcode("12345678901234", Type.Code128)
code128.SaveImageFile("shipping.png")

Dim ean13 As New Barcode("5901234123457", Type.EAN13)
ean13.SaveImageFile("product.png")

' NetBarcode— formats that produce CS0117 compile errors
' Dim qr As New Barcode("data", Type.QRCode)     ' error CS0117
' Dim dm As New Barcode("data", Type.DataMatrix) ' error CS0117
' Dim p417 As New Barcode("data", Type.PDF417)   ' error CS0117
' Dim aztec As New Barcode("data", Type.Aztec)   ' error CS0117

Branchen, in denen diese Grenze zu einer Einschränkung wird, sind beispielsweise die pharmazeutische Rückverfolgung (DataMatrix ist gemäß den FDA-Vorgaben für 2D-Barcodes erforderlich), Bordkarten von Fluggesellschaften (Aztec), Logistikmanifeste (PDF417) und mobiles Marketing (QR-Code). Jede dieser Anforderungen schließt NetBarcodeals eigenständige Lösung aus.

IronBarcode Ansatz

IronBarcode stellt alle unterstützten Formate über dieselbe BarcodeWriter.CreateBarcode Methode bereit. Die API-Oberfläche ändert sich nicht beim Übergang von einem 1D-Format zu einem 2D-Format – nur die Konstante BarcodeEncoding unterscheidet sich.

using IronBarCode;

// 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("shipping.png");

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

// 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-label.png");

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec)
    .SaveAsPng("boarding-pass.png");

using IronBarCode;

// 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("shipping.png");

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

// 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-label.png");

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec)
    .SaveAsPng("boarding-pass.png");

Imports IronBarCode

' 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128) _
    .SaveAsPng("shipping.png")

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

' 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .SaveAsPng("qr.png")

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix) _
    .SaveAsPng("pharma-label.png")

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec) _
    .SaveAsPng("boarding-pass.png")

Die vollständige Liste der unterstützten Konstanten finden Sie in der Referenz der unterstützten Barcode-Formate . Diese umfasst alle 2D-Barcode-Generierungsformate sowie den kompletten 1D-Satz.

NetBarcode-Ansatz

Das Generierungsmodell von NetBarcodebasiert auf dem Konstruktor. Ein Barcode-Objekt wird mit der Datenzeichenfolge und einem Type-Enum-Wert instanziiert. Die Ausgabe wird entweder direkt mit SaveImageFile() gespeichert oder über GetImage() als Image<Rgba32> abgerufen. Seit Version 1.8 ist der Rückgabetyp von GetImage() der Typ SixLabors.ImageSharp, was bedeutet, dass jeder Code, der den Rückgabewert speichert oder verarbeitet, die ImageSharp-API importieren und innerhalb dieser arbeiten muss.

using NetBarcode;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

// Constructor-based creation
var barcode = new Barcode("12345678901234", Type.Code128);

// Save to file — straightforward
barcode.SaveImageFile("code128.png");

// GetImage() returns Image<Rgba32> — ImageSharp import required
Image<Rgba32> image = barcode.GetImage();

// Further processing requires familiarity with the ImageSharp API
using var stream = new MemoryStream();
image.SaveAsPng(stream);
byte[] bytes = stream.ToArray();

using NetBarcode;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

// Constructor-based creation
var barcode = new Barcode("12345678901234", Type.Code128);

// Save to file — straightforward
barcode.SaveImageFile("code128.png");

// GetImage() returns Image<Rgba32> — ImageSharp import required
Image<Rgba32> image = barcode.GetImage();

// Further processing requires familiarity with the ImageSharp API
using var stream = new MemoryStream();
image.SaveAsPng(stream);
byte[] bytes = stream.ToArray();

Imports NetBarcode
Imports SixLabors.ImageSharp
Imports SixLabors.ImageSharp.PixelFormats
Imports System.IO

' Constructor-based creation
Dim barcode As New Barcode("12345678901234", Type.Code128)

' Save to file — straightforward
barcode.SaveImageFile("code128.png")

' GetImage() returns Image(Of Rgba32) — ImageSharp import required
Dim image As Image(Of Rgba32) = barcode.GetImage()

' Further processing requires familiarity with the ImageSharp API
Using stream As New MemoryStream()
    image.SaveAsPng(stream)
    Dim bytes As Byte() = stream.ToArray()
End Using

Der Rückgabetyp der Methode GetImage() verknüpft nachgelagerten Code mit der ImageSharp-Bibliothek. Jede Methode, die das Ergebnis akzeptiert oder speichert, muss es als Image<Rgba32> deklarieren, wodurch eine transitive Abhängigkeit im aufrufenden Code eingeführt wird.

IronBarcode Ansatz

IronBarcode verwendet eine flüssige Kette. BarcodeWriter.CreateBarcode gibt ein GeneratedBarcode-Objekt zurück, das mehrere Ausgabemethoden enthält. Die Bildverarbeitung erfolgt intern – dem aufrufenden Code wird kein ImageSharp-Typ zugänglich gemacht.

using IronBarCode;

// Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("code128.png");

// Multiple output options on the same GeneratedBarcode object
var barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128);
barcode.SaveAsPng("code128.png");
barcode.SaveAsJpeg("code128.jpg");
byte[] bytes = barcode.ToPngBinaryData();

using var stream = new MemoryStream();
barcode.SaveAsPng(stream);

using IronBarCode;

// Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("code128.png");

// Multiple output options on the same GeneratedBarcode object
var barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128);
barcode.SaveAsPng("code128.png");
barcode.SaveAsJpeg("code128.jpg");
byte[] bytes = barcode.ToPngBinaryData();

using var stream = new MemoryStream();
barcode.SaveAsPng(stream);

Imports IronBarCode

' Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128) _
    .SaveAsPng("code128.png")

' Multiple output options on the same GeneratedBarcode object
Dim barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
barcode.SaveAsPng("code128.png")
barcode.SaveAsJpeg("code128.jpg")
Dim bytes As Byte() = barcode.ToPngBinaryData()

Using stream As New MemoryStream()
    barcode.SaveAsPng(stream)
End Using

Detaillierte Optionen zur Generierung von 1D-Barcodes, einschließlich Breite, Höhe und Etikettenkonfiguration, werden in der IronBarcode Dokumentation beschrieben.

NetBarcode-Ansatz

NetBarcode verfügt über keine Lese-API. Es gibt keine Methode, Klasse oder Konfiguration, die ein Barcode-Bild wieder in seine Datenzeichenfolge dekodiert. Dies ist eine bewusste Abgrenzung des Geltungsbereichs, keine Auslassung bis zur Veröffentlichung. Ein Projekt, das mit NetBarcodeBarcodes generiert und diese später lesen muss – beispielsweise um ein gedrucktes Etikett zu validieren, eine Retoure zu scannen oder Werte aus einer Lieferantenrechnung zu extrahieren –, muss zu diesem Zweck eine separate Bibliothek einführen.

// NetBarcode— no reading method exists
// The following does not compile because the method does not exist:
// var result = barcode.Read("image.png");  // method does not exist

// The typical workaround requires ZXing.Net as a third-party dependency

// NetBarcode— no reading method exists
// The following does not compile because the method does not exist:
// var result = barcode.Read("image.png");  // method does not exist

// The typical workaround requires ZXing.Net as a third-party dependency

' NetBarcode— no reading method exists
' The following does not compile because the method does not exist:
' Dim result = barcode.Read("image.png")  ' method does not exist

' The typical workaround requires ZXing.Net as a third-party dependency

Die ZXing .NET -Bibliothek ist die am häufigsten verwendete Ergänzung zum Lesen von QR-Codes zusammen mit NetBarcode. Sie bietet eine dritte API-Oberfläche und ein drittes Paket, das neben NetBarcodeund bereits hinzugefügten 2D-Bibliotheken für QR-Codes versioniert werden muss.

IronBarcode Ansatz

IronBarcode enthält BarcodeReader im selben Paket wie BarcodeWriter. Die Lese-API akzeptiert Bilddateien und PDF-Dokumente und gibt eine Sammlung dekodierter Ergebnisse zurück, die jeweils den Barcode-Wert, den Formattyp und, falls aus einer PDF-Datei gelesen, die Seitenzahl enthalten.

using IronBarCode;

// Read barcodes from an image file
var imageResults = BarcodeReader.Read("shipping-label.png");
foreach (var r in imageResults)
{
    Console.WriteLine($"{r.BarcodeType}: {r.Value}");
}

// Read barcodes from a PDF document — no additional library required
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var r in pdfResults)
{
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}");
}

using IronBarCode;

// Read barcodes from an image file
var imageResults = BarcodeReader.Read("shipping-label.png");
foreach (var r in imageResults)
{
    Console.WriteLine($"{r.BarcodeType}: {r.Value}");
}

// Read barcodes from a PDF document — no additional library required
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var r in pdfResults)
{
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}");
}

Imports IronBarCode

' Read barcodes from an image file
Dim imageResults = BarcodeReader.Read("shipping-label.png")
For Each r In imageResults
    Console.WriteLine($"{r.BarcodeType}: {r.Value}")
Next

' Read barcodes from a PDF document — no additional library required
Dim pdfResults = BarcodeReader.Read("invoice.pdf")
For Each r In pdfResults
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}")
Next

Der Leitfaden zum Lesen von Barcodes aus Bildern behandelt die Geschwindigkeitsoptimierung, die Erkennung mehrerer Barcodes und die in der Lese-API verfügbaren Bildkorrekturoptionen.

NetBarcodeund ImageSharp

NetBarcode ist unter der MIT-Lizenz veröffentlicht. Die Bibliothek SixLabors.ImageSharp, von der sie abhängt, verwendet ein anderes Modell: kostenlos für Open-Source-Projekte und für Unternehmen mit einem jährlichen Bruttoumsatz unterhalb einer definierten Schwelle, aber oberhalb dieser Schwelle ist eine kommerzielle Lizenz erforderlich. Diese Aufteilung gilt unabhängig davon, ob ImageSharp explizit in der Projekt-ID .csproj aufgeführt ist oder transitiv über NetBarcodeübertragen wird.

<PackageReference Include="NetBarcode" Version="1.8.2" />

<PackageReference Include="NetBarcode" Version="1.8.2" />

Für ein Einzelhandels- oder Logistikunternehmen, das Barcodes in großem Umfang verarbeitet – der primäre Anwendungsfall von NetBarcode–, liegt der Jahresumsatz oft über der Schwelle, ab der die kommerzielle ImageSharp-Lizenz gilt. Eine Compliance-Prüfung kann diese im Paketbaum eingebettete Verpflichtung aufdecken.

Mit der Version 1.8 kam eine weitere Folge der ImageSharp-Abhängigkeit hinzu: Der Rückgabetyp von GetImage() änderte sich von einer internen Darstellung zu SixLabors.ImageSharp.Image<Rgba32>. Vorhandener Code, der GetImage() ohne explizite Typangabe aufrief, führte zu einem Kompilierfehler, und neue using-Direktiven für SixLabors.ImageSharp und SixLabors.ImageSharp.PixelFormats wurden erforderlich. Wenn sich die API von ImageSharp in zukünftigen Versionen weiterentwickelt, wird dies wiederum die öffentliche API-Oberfläche von NetBarcodebeeinflussen.

IronBarcode

IronBarcode hat keine Abhängigkeit von SixLabors.ImageSharp. Die Lizenzbedingungen sind direkt auf derIronBarcode -Lizenzseite angegeben, ohne Aufteilung der Schwellenwerte oder transitive kommerzielle Verpflichtungen. Zur Evaluierung steht ein Testschlüssel zur Verfügung; Mit den erworbenen Lizenzen wird das Testwasserzeichen aus der generierten Ausgabe entfernt.

Anforderungen an QR-Code und 2D-Format

Der häufigste Anlass für die Prüfung einer Alternative zu NetBarcodeist eine neue Anforderung an QR-Codes. Anwendungen, die mit der Generierung von 1D-Barcodes für Einzelhandelsetiketten oder Versandmanifeste beginnen, erhalten häufig im Anschluss die Anforderung von QR-Codes – kontaktlose Links, Deep Links für mobile Apps, Marketingkampagnen. Da die Enumeration Type keinen QR-Eintrag besitzt, kann diese Anforderung innerhalb von NetBarcodenicht erfüllt werden. Teams, die eine separate QR-Bibliothek hinzufügen, um die Lücke zu schließen, stehen dann vor einer zweiten Bewertung, wenn DataMatrixfür eine pharmazeutische Integration benötigt wird oder PDF417für einen Logistikdienstleister, der es auf Versandetiketten vorschreibt.

Barcode-Lesen wird notwendig

Manche Projekte beginnen mit der reinen Generierung und fügen später eine Validierungs- oder Dokumentenverarbeitungsanforderung hinzu: Bestätigung, dass ein gedruckter Barcode mit seinen Quelldaten übereinstimmt, Extrahieren von Barcode-Werten aus eingehenden Lieferantenrechnungen oder Scannen von Rücksendeetiketten. NetBarcodebietet hierfür keine Möglichkeit. Die Hinzunahme von ZXing .NET oder einer vergleichbaren Lesebibliothek führt zu einer dritten API, die in derselben Codebasis, die bereits NetBarcodeund eine QR-Bibliothek enthält, erlernt und gepflegt werden muss. Bei Projekten, die Leseanforderungen auch in einer späteren Phase berücksichtigen, ist es oft effizienter, von Anfang an eine Bibliothek auszuwählen, die beide Anforderungen erfüllt.

ImageSharp-Kommerzlizenzprüfung

Bei rechtlichen und Compliance-Prüfungen von Drittanbieterabhängigkeiten wird gelegentlich die im NetBarcode-Paketbaum eingebettete kommerzielle Lizenzbedingung von SixLabors.ImageSharp aufgedeckt. Für Unternehmen, deren jährlicher Bruttoumsatz die Schwelle überschreitet, gilt die Verpflichtung unabhängig davon, ob ImageSharp bewusst ausgewählt wurde oder passiv über NetBarcodedazugekommen ist. Teams, die dies erst im Rahmen eines Audits – und nicht vor der Einführung – feststellen, müssen nachträglich Abhilfe schaffen, anstatt eine geplante Migration durchführen zu können. Die Lizenz der Abhängigkeiten vor Beginn eines Projekts zu prüfen, ist der sauberere Weg.

Reduzierung der Komplexität mehrerer Bibliotheken

Teams, die NetBarcodefür die 1D-Generierung, eine QR-spezifische Bibliothek für die 2D-Ausgabe und ZXing .NET zum Lesen angesammelt haben, sehen sich mit der Herausforderung konfrontiert, die Versionskompatibilität über drei separate Pakete hinweg aufrechtzuerhalten. Bei jedem Upgrade-Zyklus muss geprüft werden, ob die drei Bibliotheken in ihrer gemeinsamen ImageSharp-Version übereinstimmen. Jeder neue Entwickler im Projekt sieht sich mit drei verschiedenen APIs für ein und dasselbe konzeptionelle Anliegen konfrontiert. Die Konsolidierung auf eine einzige Barcode-Bibliothek vereinfacht das Onboarding, reduziert die Angriffsfläche für Versionskonflikte und konzentriert die Wartung auf einen einzigen Release-Zyklus.

Pakettausch und Bereinigung transitiver Abhängigkeiten

Das Entfernen von NetBarcodemit dotnet remove package NetBarcode ist der erste Schritt. Das Paket SixLabors.ImageSharp kann im Abhängigkeitsbaum wieder auftauchen, wenn andere Pakete im Projekt es ebenfalls transitiv einbinden. Nach der Deinstallation überprüfen Sie mit dotnet list package --include-transitive die wiederhergestellte Paketliste, um zu bestätigen, ob ImageSharp noch vorhanden ist und ob die kommerzielle Lizenzbedingung noch gilt.

Ersetzung des Rückgabetyps von GetImage()

Jeglicher Code, der das Ergebnis von GetImage() als Image<Rgba32> speichert, muss aktualisiert werden. Der ImageSharp-Typ hat kein direktes Äquivalent in IronBarcode; Der Ersatz hängt davon ab, wie das Bild weiterverwendet wurde. Der Code, der das Bild in einem Stream speicherte, kann durch .SaveAsPng(stream) direkt im GeneratedBarcode Objekt ersetzt werden. Code, der Rohbytes abruft, kann .ToPngBinaryData() verwenden. Code, der weitere ImageSharp-Manipulationen am zurückgegebenen Bild vornimmt, erfordert, dass diese Operationen einzeln ausgewertet werden.

Namespace-Aktualisierung

Bei Dateien, die using NetBarcode;, using SixLabors.ImageSharp;, using SixLabors.ImageSharp.PixelFormats; oder using SixLabors.Fonts; importiert haben, müssen diese Direktiven durch using IronBarCode;ersetzt werden. Eine projektweite Suche nach diesen using-Anweisungen identifiziert jede Datei, die vor dem Build-Versuch Aufmerksamkeit erfordert.