Die Entwurfsgrenze des Typ-Enums

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

// NetBarcodeType enum — complete list as of v1.8
public enum Type
{
    Codabar,
    Code11,
    Code128,
    Code128A,
    Code128B,
    Code128C,
    Code39,
    Code39E,
    Code93,
    EAN13,
    EAN8
}

// 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
// Type.UPCA        — does not exist
// Type.UPCE        — does not exist
// Type.ITF         — does not exist
// Type.MSI         — does not exist

// NetBarcodeType enum — complete list as of v1.8
public enum Type
{
    Codabar,
    Code11,
    Code128,
    Code128A,
    Code128B,
    Code128C,
    Code39,
    Code39E,
    Code93,
    EAN13,
    EAN8
}

// 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
// Type.UPCA        — does not exist
// Type.UPCE        — does not exist
// Type.ITF         — does not exist
// Type.MSI         — does not exist

' NetBarcodeType enum — complete list as of v1.8
Public Enum Type
    Codabar
    Code11
    Code128
    Code128A
    Code128B
    Code128C
    Code39
    Code39E
    Code93
    EAN13
    EAN8
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
' Type.UPCA        — does not exist
' Type.UPCE        — does not exist
' Type.ITF         — does not exist
' Type.MSI         — does not exist

Das Enum hat elf Einträge in acht linearen Symbologiefamilien, und das spiegelt den intendierten Umfang der Bibliothek wider. Jede Anwendung, die QR-Codes, DataMatrix, PDF417, Aztec, UPC-A, UPC-E, ITF oder MSI benötigt, muss ein separates Paket erwerben, um diese Formate bereitzustellen.

Detaillierter Funktionsvergleich

NetBarcode-Ansatz

NetBarcode bietet 11 lineare Barcode-Aufzählungswerte über 8 Symbologie-Familien durch die Type-Aufzählung. 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
// var upca   = new Barcode("data", Type.UPCA);        // error CS0117
// var itf    = new Barcode("data", Type.ITF);         // 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
// var upca   = new Barcode("data", Type.UPCA);        // error CS0117
// var itf    = new Barcode("data", Type.ITF);         // 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
' Dim upca As New Barcode("data", Type.UPCA)     ' error CS0117
' Dim itf As New Barcode("data", Type.ITF)       ' 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 macht alle unterstützten Formate über die gleiche BarcodeWriter.CreateBarcode-Methode zugänglich. Die API-Oberfläche ändert sich nicht beim Wechsel von einem 1D- zu einem 2D-Format – nur die BarcodeEncoding-Konstante 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 dem Datenstring und einem Type-Aufzählungswert instanziiert. Die Ausgabe wird entweder direkt mit SaveImageFile() gespeichert oder als Image<Rgba32> über GetImage() abgerufen. Seit Version 1.8 ist der Rückgabetyp von GetImage() der SixLabors.ImageSharp-Typ, 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 GetImage()-Methode bindet nachfolgenden Code an die ImageSharp-Bibliothek. Jede Methode, die das Ergebnis akzeptiert oder speichert, muss es als Image<Rgba32> deklarieren und eine transitive Abhängigkeit in den aufrufenden Code einführen.

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 gleichen 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.Format}: {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.Format}: {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.Format}: {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 im .csproj eines Projekts aufgeführt ist oder transitiv durch NetBarcodeankommt.

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

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

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.

Die Veröffentlichung von v1.8 führte zu einer zusätzlichen Konsequenz der ImageSharp-Abhängigkeit: Der Rückgabetyp von GetImage() änderte sich von einer internen Darstellung zu SixLabors.ImageSharp.Image<Rgba32>. Vorhandener Code, der GetImage() ohne explizite Typisierung aufrief, brach zur Kompilierzeit, 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. Weil die Type-Aufzählung keinen QR-Eintrag hat, 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 SixLabors.ImageSharp-Paket kann in der Abhängigkeitskette wieder auftauchen, wenn andere Pakete im Projekt es auch transitiv ziehen. Nach der Entfernung inspizieren Sie die wiederhergestellte Paketliste mit dotnet list package --include-transitive, um zu bestätigen, ob ImageSharp noch vorhanden ist und ob seine kommerzielle Lizenzbedingung noch gilt.

Ersetzung des Rückgabetyps von GetImage()

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

Namespace-Aktualisierung

Dateien, die using NetBarcode;, using SixLabors.ImageSharp;, using SixLabors.ImageSharp.PixelFormats; oder using SixLabors.Fonts; importierten, benötigen, dass diese Direktiven mit using IronBarCode; ersetzt werden. Eine projektweite Suche nach diesen using-Anweisungen identifiziert jede Datei, die vor dem Build-Versuch Aufmerksamkeit erfordert.