Barcode4NET-Generierungs-API

Der gesamte Generierungsworkflow in Barcode4NETverwendete ein Property-Setter-Muster:

// Barcode4NET— manual DLL, .NET Frameworkonly
//NeinNuGet-Paket— requires ThirdParty/Barcode4NET/Barcode4NET.dll in source control
using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

var barcode = new Barcode4NET.Barcode();
barcode.Symbology = Symbology.Code128;
barcode.Data = "ITEM-12345";
barcode.Width = 300;
barcode.Height = 100;
Bitmap barcodeImage = barcode.GenerateBarcode();
barcodeImage.Save(outputPath, ImageFormat.Png);

// Barcode4NET— manual DLL, .NET Frameworkonly
//NeinNuGet-Paket— requires ThirdParty/Barcode4NET/Barcode4NET.dll in source control
using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

var barcode = new Barcode4NET.Barcode();
barcode.Symbology = Symbology.Code128;
barcode.Data = "ITEM-12345";
barcode.Width = 300;
barcode.Height = 100;
Bitmap barcodeImage = barcode.GenerateBarcode();
barcodeImage.Save(outputPath, ImageFormat.Png);

Imports Barcode4NET
Imports System.Drawing
Imports System.Drawing.Imaging

Dim barcode As New Barcode4NET.Barcode()
barcode.Symbology = Symbology.Code128
barcode.Data = "ITEM-12345"
barcode.Width = 300
barcode.Height = 100
Dim barcodeImage As Bitmap = barcode.GenerateBarcode()
barcodeImage.Save(outputPath, ImageFormat.Png)

Dies stellt den gesamten Funktionsumfang der Barcode4NET-API dar. Die Bibliothek bot keine fluente Verkettung, keine Lesefähigkeit, keine QR-Code-Unterstützung und keine erweiterten 2D-Optionen wie Logo-Einbettung oder Fehlerkorrekturkontrolle.

Detaillierter Funktionsvergleich

Barcode4NET-Ansatz

Barcode4NET verwendete ein imperatives Eigenschaftssetzer-Muster. Entwickler instanziierten ein Barcode-Objekt, wiesen einzelne Eigenschaften zu und riefen GenerateBarcode() auf, um ein System.Drawing.Bitmap zu erhalten:

using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

public Bitmap GenerateLabel(string sku)
{
    var barcode = new Barcode4NET.Barcode();
    barcode.Symbology = Symbology.Code128;
    barcode.Data = sku;
    barcode.Width = 400;
    barcode.Height = 120;
    return barcode.GenerateBarcode();
}

using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

public Bitmap GenerateLabel(string sku)
{
    var barcode = new Barcode4NET.Barcode();
    barcode.Symbology = Symbology.Code128;
    barcode.Data = sku;
    barcode.Width = 400;
    barcode.Height = 120;
    return barcode.GenerateBarcode();
}

Imports Barcode4NET
Imports System.Drawing
Imports System.Drawing.Imaging

Public Function GenerateLabel(sku As String) As Bitmap
    Dim barcode As New Barcode4NET.Barcode()
    barcode.Symbology = Symbology.Code128
    barcode.Data = sku
    barcode.Width = 400
    barcode.Height = 120
    Return barcode.GenerateBarcode()
End Function

Der Rückgabetyp — System.Drawing.Bitmap — bedeutete, dass der aufrufende Code dafür verantwortlich war, das Bild zu speichern, anzuzeigen oder zu streamen. Dies war geeignet für WinForms-Anwendungen, bei denen einem Bitmap direkt ein PictureBox zugewiesen werden konnte, erforderte jedoch zusätzliche Konvertierungsschritte für jedes andere Ausgabemedium.

IronBarcode Ansatz

IronBarcode verwendet eine flüssige statische API. Ein einzelner Methodenaufruf initiiert die Generierung, und verkettbare Methoden konfigurieren das Ergebnis vor einer abschließenden Speicher- oder Konvertierungsmethode:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateLabel(string sku)
{
    return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128)
        .ResizeTo(400, 120)
        .ToPngBinaryData();
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateLabel(string sku)
{
    return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128)
        .ResizeTo(400, 120)
        .ToPngBinaryData();
}

Imports IronBarCode

Public Function GenerateLabel(sku As String) As Byte()
    Return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128) _
        .ResizeTo(400, 120) _
        .ToPngBinaryData()
End Function

Das BarcodeEncoding enum entspricht direkt dem Symbology enum. .ResizeTo() ersetzt die Width und Height Eigenschaftszuweisungen. Terminalmethoden — .SaveAsPng(), .SaveAsJpeg(), .ToPngBinaryData() — ersetzen die separaten GenerateBarcode() und Bitmap-Speicheraufrufe. Für komplexere Generierungsszenarien siehe die IronBarcode Dokumentation zur Barcode-Generierung .

Barcode4NET-Ansatz

Barcode4NET besaß keine Lese-API. Teams, die Barcodes aus Bildern oder gescannten Dokumenten dekodieren mussten, mussten eine komplett separate Bibliothek integrieren – entweder ZXing .NET, eine Open-Source-Alternative, oder ein kommerzielles Scanner-SDK. Das Ergebnis waren zwei separate Abhängigkeitsketten: Barcode4NETzur Generierung und eine zweite Bibliothek zum Lesen.

IronBarcode Ansatz

IronBarcode bietet BarcodeReader.Read() als statische Methode an, die Bilddateipfade, Stream-Objekte und PDF-Dokumente akzeptiert:

using IronBarCode;

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

// Read all barcodes from a multi-page PDF — no extra PDF library required
var pdfResults = BarcodeReader.Read("invoice-batch.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

using IronBarCode;

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

// Read all barcodes from a multi-page PDF — no extra PDF library required
var pdfResults = BarcodeReader.Read("invoice-batch.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

Imports IronBarCode

' Read from an 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 all barcodes from a multi-page PDF — no extra PDF library required
Dim pdfResults = BarcodeReader.Read("invoice-batch.pdf")
For Each result In pdfResults
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}")
Next

In Szenarien mit hohem Volumen oder geräuschlastigen Bildern bietet die BarcodeReaderOptions-Klasse Kontrolle über Lesegeschwindigkeit und Multi-Barcode-Erkennung. Informationen zu den Konfigurationsoptionen finden Sie in der Dokumentation zum Barcode-Lesen .

Barcode4NET-Ansatz

Barcode4NET wurde gegen .NET Framework-Assemblys kompiliert. Es lief unter Windows, in .NET FrameworkAnwendungen, in IIS-gehosteten Web Forms- und Windows Forms-Projekten. Es gab keine Linux-Versionen, keine .NET Core Versionen und keine Unterstützung für Cloud-Laufzeitumgebungen. Als Microsoft .NET Core einführte und später die Plattform als .NET 5+ vereinheitlichte, gab es für Barcode4NETkeine entsprechenden Aktualisierungen. Jedes Projekt, das auf net5.0 oder später abzielt, konnte die Bibliothek überhaupt nicht referenzieren.

Das DLL-Verteilungsmodell verschärfte die Plattformbeschränkung zusätzlich. Jede Build-Umgebung – Entwickler-Workstation, Build-Agent, Docker-Container – erforderte, dass die DLL unter einem bekannten Pfad vorhanden war. In containerbasierten Bereitstellungen bedeutete dies entweder, die DLL in ein benutzerdefiniertes Basis-Image einzubacken oder sie während des Container-Builds zu kopieren, was mit standardisierten dotnet restore Workflows nicht kompatibel ist.

IronBarcode Ansatz

IronBarcode unterstützt mehrere Frameworks über ein einziges NuGet Paket: .NET Framework4.6.2 bis .NET 9 sowie alle aktuellen .NET Versionen unter Windows, Linux und macOS. Die Bereitstellung in Docker-Containern verwendet die standardmäßigen .NET -Laufzeitabbilder ohne Modifikation. Azure Functions, AWS Lambda und andere serverlose Laufzeitumgebungen werden über dasselbe NuGet Paket unterstützt. Der dotnet restore-Befehl löst alle Abhängigkeiten ohne jegliches manuelle DLL-Management.

Barcode4NET-Ansatz

Barcode4NET ist effektiv end-of-life. Neue Lizenzen werden nicht mehr über ComponentSource verkauft, obwohl bestehende Kunden Support und Software-Updates gemäß den Bedingungen des Anbieters über ComponentSource erneuern können. Wenn ein neuer Entwickler einem Team beitritt, das Barcode4NETverwendet, gibt es keinen Mechanismus, um einen zusätzlichen Sitzplatz für ihn zu erwerben. Die letzte Codeveröffentlichung war Version 2.0 im Jahr 2007, daher werden entdeckte Fehler oder Sicherheitsprobleme seit dieser Veröffentlichung nicht durch Patches behoben.

IronBarcode Ansatz

IronBarcode ist ein aktiv gepflegtes kommerzielles Produkt mit unbefristeter Lizenz. Die Preise beginnen bei 749 US-Dollar für eine Lite Lizenz für einen einzelnen Entwickler. Darüber hinaus sind die Stufen Plus (1.499 US-Dollar, 3 Entwickler), Professional (2.999 US-Dollar, 10 Entwickler) und Unlimited (5.999 US-Dollar) erhältlich. Alle Pakete beinhalten eine lizenzgebührenfreie Bereitstellung. Sicherheitspatches, Bugfixes und Kompatibilitätsupdates für die .NET Version werden in regelmäßigen Abständen veröffentlicht. Eine 30-tägige kostenlose Testversion steht ohne Lizenzschlüssel zur Verfügung.

.NET -Upgrade blockiert

Der häufigste Auslöser ist ein .NET Modernisierungsprojekt. Ein Team zielt in ihrem .csproj auf net8.0 ab, führt den Build aus und begegnet einem Ladefehler, da Barcode4NETfor .NET Framework1.1 / 2.0 / 3.x erstellt wurde und nicht von einem modernen .NET-Ziel referenziert werden kann. An diesem Punkt steht das Team vor einer binären Entscheidung: Entweder die Änderung des Zielframeworks rückgängig machen und beim .NET Frameworkbleiben, oder Barcode4NETersetzen. Die Migration kann nicht verschoben werden, ohne die umfassenderen Modernisierungsbemühungen zu blockieren.

CI/CD-Pipeline-Fehler nach Infrastrukturänderungen

Das DLL-Verteilungsmodell von Barcode4NETerzeugt eine latente Anfälligkeit in den Build-Pipelines. Wenn ein Build-Agent neu bereitgestellt, ein Container-Image aktualisiert oder eine neue CI-Umgebung konfiguriert wird, muss die Barcode4NET-DLL manuell an dem Pfad abgelegt werden, den die Projektdatei erwartet. Teams, die diesen Schritt nicht sorgfältig dokumentiert haben, entdecken das Problem erst, wenn die Pipeline ausfällt. Der Wechsel zu IronBarcode bedeutet, dass dotnet restore alles übernimmt — das Problem der DLL-Positionierung existiert nicht mehr.

Neue Teammitglieder können nicht lizenziert werden

Wenn ein externer Auftragnehmer dem Projekt beitritt oder ein zweiter Entwickler an Barcode-Funktionen arbeiten muss, ist keine Lizenz zu erwerben. Das Team muss diese Einschränkung umgehen – entweder der neue Entwickler vermeidet den Barcode-Code vollständig, oder jemand überträgt eine Lizenz, die unter den ursprünglichen Bedingungen möglicherweise nicht rechtsgültig übertragbar ist. Keine der beiden Situationen ist für ein Team, das aktiv an der Produktentwicklung arbeitet, tragbar.

Sicherheits- und Compliance-Audits

Organisationen, die die Generierung von Software-Stücklisten durchführen oder Abhängigkeiten anhand von Datenbanken, die das Ende ihres Lebenszyklus erreicht haben, überprüfen, stoßen dabei auf Barcode4NET. Es ist ein kommerzielles Produkt ohne Codeveröffentlichung seit 2007 und ohne CVE-Tracking oder Patch-Stream. Sicherheitsprüfer behandeln Abhängigkeiten in diesem Zustand typischerweise anders als aktiv gepflegte Bibliotheken, und der Befund wird oft zu einem formellen Sanierungselement anstelle eines aufgeschobenen Risikos.

Lesefunktion zu einem bestehenden Workflow hinzugefügt

Teams, die Barcode4NETursprünglich nur für Generierungs-Workflows verwendet haben, stellen später fest, dass sie Barcodes von gescannten Dokumenten überprüfen, vom Benutzer hochgeladene Bilder verarbeiten oder Daten aus PDF-Rechnungen extrahieren müssen. Bei Barcode4NETist hierfür die Integration einer zweiten Bibliothek erforderlich. IronBarcodes BarcodeReader.Read() verarbeitet sowohl Bilder als auch PDFs nativ und konsolidiert die Abhängigkeit in ein einziges gepflegtes Paket.

Entfernen des DLL-Verweis

Barcode4NET wurde nie als ein NuGet-Paket vertrieben, daher gibt es keinen dotnet remove package-Befehl. Jede .csproj-Datei, die die Bibliothek referenziert, enthält ein <Reference Include="Barcode4NET">-Element mit einem <HintPath>, der auf die DLL auf der Festplatte verweist. Jedes dieser Elemente muss manuell gefunden und entfernt werden. Ein grep-Befehl, der die Lösung durchsucht, findet sie:

grep -rl "Barcode4NET" --include="*.csproj" .

grep -rl "Barcode4NET" --include="*.csproj" .

Das DLL-Verzeichnis in der Versionskontrolle — typischerweise ThirdParty/Barcode4NET/ oder lib/—muss auch zur Löschung mit git rm bereitgestellt werden.

Änderung des Rückgabetyps von Bitmap zu Byte-Array

Barcode4NET's GenerateBarcode() gibt ein System.Drawing.Bitmap zurück. IronBarcodes fluente Kette endet mit .ToPngBinaryData(), das byte[] zurückgibt, oder .SaveAsPng(), das direkt auf die Festplatte schreibt. Code, der den Rückgabewert einer Bitmap-typisierten Variablen zuweist oder ihn an eine Methode übergibt, die ein Bitmap erwartet — wie eine WinForms PictureBox — erfordert eine Einzeilenanpassung an der Aufrufstelle: Wickeln Sie das Byte-Array in ein MemoryStream und rufen Sie Image.FromStream() auf.

Symbolisierung Enum Umbenennen

Das Symbology enum in Barcode4NETentspricht direkt dem BarcodeEncoding enum in IronBarcode. Alle gemeinsamen Werte — Code128, Code39, EAN13, UPCA, QRCode — behalten ihre Namen. Ein lösungsweites Suchen-und-Ersetzen von Symbology. mit BarcodeEncoding. deckt die meisten Fälle ab, obwohl jede Ersetzung überprüft werden sollte, um den Kontext zu bestätigen.

Build-Skriptbereinigung

Die Build-Skripte und CI/CD-Konfigurationsdateien, die die Barcode4NET-DLL in Ausgabeverzeichnisse oder Build-Agents kopieren, müssen aktualisiert werden. Diese Schritte haben nach der NuGet-Migration kein Äquivalent — dotnet restore ersetzt die gesamte manuelle DLL-Verwaltung. Das Belassen veralteter DLL-Kopierschritte nach der Migration führt zwar nicht zu Build-Fehlern, stellt aber eine tote Konfiguration dar, die für zukünftige Wartungsteams Verwirrung stiftet.