BarcodeLib vs IronBarcode: C# Barcode Bibliothek Vergleich

BarcodeLibCore-Generierungsmuster

Der Standard-Workflow für die BarcodeLib-Generierung erfordert das Erstellen einer Instanz, das Konfigurieren von Eigenschaften und den Aufruf von Encode():

// BarcodeLib
using BarcodeLib;
using System.Drawing;
using System.Drawing.Imaging;

var b = new Barcode();
b.IncludeLabel = true;
b.Width = 300;
b.Height = 100;
Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345");
img.Save("barcode.png", ImageFormat.Png);

// BarcodeLib
using BarcodeLib;
using System.Drawing;
using System.Drawing.Imaging;

var b = new Barcode();
b.IncludeLabel = true;
b.Width = 300;
b.Height = 100;
Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345");
img.Save("barcode.png", ImageFormat.Png);

Imports BarcodeLib
Imports System.Drawing
Imports System.Drawing.Imaging

Dim b As New Barcode()
b.IncludeLabel = True
b.Width = 300
b.Height = 100
Dim img As Image = b.Encode(TYPE.CODE128, "PRODUCT-12345")
img.Save("barcode.png", ImageFormat.Png)

Dies ist der vollständige Generierungsablauf. Das Property-Setter-Muster ist das Design: Die gesamte Konfiguration erfolgt auf der Instanz vor dem Encode()-Aufruf, und der Rückgabewert ist ein System.Drawing.Image, der separat gespeichert oder in Bytes konvertiert werden muss.

Detaillierter Funktionsvergleich

BarcodeLib-Ansatz

BarcodeLib erfordert das Erstellen einer Instanz und das Festlegen von Eigenschaften, bevor Encode() aufgerufen wird. Die Ausgabe ist ein System.Drawing.Image Objekt:

using BarcodeLib;
using System.Drawing;
using System.Drawing.Imaging;

public byte[] GenerateCode128(string data)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    b.Width = 300;
    b.Height = 100;
    Image img = b.Encode(TYPE.CODE128, data);

    using var ms = new MemoryStream();
    img.Save(ms, ImageFormat.Png);
    return ms.ToArray();
}

using BarcodeLib;
using System.Drawing;
using System.Drawing.Imaging;

public byte[] GenerateCode128(string data)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    b.Width = 300;
    b.Height = 100;
    Image img = b.Encode(TYPE.CODE128, data);

    using var ms = new MemoryStream();
    img.Save(ms, ImageFormat.Png);
    return ms.ToArray();
}

Imports BarcodeLib
Imports System.Drawing
Imports System.Drawing.Imaging
Imports System.IO

Public Function GenerateCode128(data As String) As Byte()
    Dim b As New Barcode()
    b.IncludeLabel = True
    b.Width = 300
    b.Height = 100
    Dim img As Image = b.Encode(TYPE.CODE128, data)

    Using ms As New MemoryStream()
        img.Save(ms, ImageFormat.Png)
        Return ms.ToArray()
    End Using
End Function

Der Rückgabetyp System.Drawing.Image bedeutet, dass für die Ausgabe eines Byte-Arrays ein Zwischenschritt MemoryStream erforderlich ist. Die Eigenschaft IncludeLabel ist ein boolescher Schalter – BarcodeLibrendert automatisch die codierte Datenzeichenfolge als sichtbare Beschriftung unterhalb der Balken.

IronBarcode Ansatz

Die Barcode-Generierung von IronBarcode ist vollständig statisch. Konfigurationsketten nach CreateBarcode() und Ausgabemethoden beenden die Kette direkt:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateCode128(string data)
{
    return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
        .ResizeTo(300, 100)
        .AddAnnotationTextBelowBarcode(data)
        .ToPngBinaryData();
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateCode128(string data)
{
    return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
        .ResizeTo(300, 100)
        .AddAnnotationTextBelowBarcode(data)
        .ToPngBinaryData();
}

Imports IronBarCode

Public Function GenerateCode128(data As String) As Byte()
    Return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
        .ResizeTo(300, 100) _
        .AddAnnotationTextBelowBarcode(data) _
        .ToPngBinaryData()
End Function

.ToPngBinaryData() gibt das Byte-Array direkt zurück – ohne Zwischenobjekt Image oder MemoryStream. .AddAnnotationTextBelowBarcode() nimmt die Beschriftungszeichenkette explizit entgegen und ermöglicht so die Kontrolle darüber, welcher Text unterhalb der Balken angezeigt wird. Für fortgeschrittene Generierungsszenarien siehe die IronBarcode Dokumentation zur Barcode-Generierung .

BarcodeLib-Ansatz

BarcodeLib besitzt keine Lese-API. Es gibt keine Decode(), Scan() oder ReadBarcode() Methode. Das Fehlen ist kein Versionsunterschied – Lesen war nie Teil des Konzepts der Bibliothek. Jeder Versuch, eine Dekodierungsmethode aufzurufen, führt zu einem Kompilierungsfehler:

// BarcodeLib— reading does not exist
using BarcodeLib;

var b = new Barcode();

// This will not compile — there is no Decode or Read method
// var value = b.Decode("barcode.png");       // CS1061: no definition
// var value = b.Scan("barcode.png");          // CS1061: no definition
// var value = b.ReadBarcode("barcode.png");   // CS1061: no definition

// The only thing you can do is generate:
Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345");  // this works

// BarcodeLib— reading does not exist
using BarcodeLib;

var b = new Barcode();

// This will not compile — there is no Decode or Read method
// var value = b.Decode("barcode.png");       // CS1061: no definition
// var value = b.Scan("barcode.png");          // CS1061: no definition
// var value = b.ReadBarcode("barcode.png");   // CS1061: no definition

// The only thing you can do is generate:
Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345");  // this works

Imports BarcodeLib

Dim b As New Barcode()

' This will not compile — there is no Decode or Read method
' Dim value = b.Decode("barcode.png")       ' CS1061: no definition
' Dim value = b.Scan("barcode.png")         ' CS1061: no definition
' Dim value = b.ReadBarcode("barcode.png")  ' CS1061: no definition

' The only thing you can do is generate:
Dim img As Image = b.Encode(TYPE.CODE128, "PRODUCT-12345")  ' this works

Teams, die neben BarcodeLibsowohl die Generierung als auch das Lesen benötigen, müssen eine zweite Bibliothek hinzufügen – typischerweise ZXing .NET –, was einen eigenen Aufwand für die Abhängigkeitsverwaltung und eine zweite zu pflegende API-Oberfläche mit sich bringt.

IronBarcode Ansatz

BarcodeReader.Read() akzeptiert Bilddateien, PDF-Dateien, Streams und System.Drawing.Bitmap Objekte. Zum Lesen einer PDF-Datei ist keine zusätzliche Bibliothek erforderlich:

using IronBarCode;

// Read from an image
var results = BarcodeReader.Read("barcode.png");
Console.WriteLine(results.First().Value);  // "PRODUCT-12345"

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

// Tune reading for speed vs. thoroughness
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-scan.png", options);

using IronBarCode;

// Read from an image
var results = BarcodeReader.Read("barcode.png");
Console.WriteLine(results.First().Value);  // "PRODUCT-12345"

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

// Tune reading for speed vs. thoroughness
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-scan.png", options);

Imports IronBarCode

' Read from an image
Dim results = BarcodeReader.Read("barcode.png")
Console.WriteLine(results.First().Value)  ' "PRODUCT-12345"

' Read all barcodes from a PDF — no separate PDF library needed
Dim pdfResults = BarcodeReader.Read("invoice-batch.pdf")
For Each result In pdfResults
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}")
Next

' Tune reading for speed vs. thoroughness
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim multiResults = BarcodeReader.Read("warehouse-scan.png", options)

Die Aufzählung ReadingSpeed ermöglicht die Optimierung der Scan-Performance für Szenarien mit hohem Datenaufkommen. Hinweise zur Konfiguration des Lesevorgangs finden Sie in der IronBarcode -Lesedokumentation .

BarcodeLib-Ansatz

Ab BarcodeLib3.x wurde SkiaSharp als Grafik-Backend eingeführt, um System.Drawing.Common zu ersetzen, das nach .NET 6 nur noch unter Windowsverfügbar war. BarcodeLibist auf einen bestimmten SkiaSharp-Versionsbereich festgelegt. Wenn ein Projekt SkiaSharp bereits über eine andere Abhängigkeit verwendet – was häufig bei MAUI-Projekten mit SkiaSharp.Views.Maui und Microsoft.Maui.Graphics der Fall ist – kann die aufgelöste Version außerhalb des von BarcodeLiberwarteten Bereichs liegen. Das Ergebnis ist mindestens eine NU1608-Warnung und schlimmstenfalls ein Assembly-Bindungsfehler zur Laufzeit:

Warnung NU1608: Paketversion außerhalb der Abhängigkeitsbeschränkung erkannt:
BarcodeLib 3.1.5 benötigt SkiaSharp (>= 2.88.7 && < 2.89.0), aber
Das Problem mit SkiaSharp Version 3.116.1 wurde behoben.

Das Erzwingen einer Auflösung durch explizite Paketverweise erhöht die Komplexität ohne Garantie:

<ItemGroup>
  <PackageReference Include="BarcodeLib" Version="3.1.5" />

  <PackageReference Include="SkiaSharp" Version="3.116.1" />
  <PackageReference Include="SkiaSharp.Views.Maui.Controls" Version="3.116.1" />
</ItemGroup>

<ItemGroup>
  <PackageReference Include="BarcodeLib" Version="3.1.5" />

  <PackageReference Include="SkiaSharp" Version="3.116.1" />
  <PackageReference Include="SkiaSharp.Views.Maui.Controls" Version="3.116.1" />
</ItemGroup>

Selbst bei expliziten Überschreibungen hängt die Kompatibilität davon ab, dass die internen API-Aufrufe von BarcodeLibmit denen der festgelegten Version übereinstimmen. Es gibt keinen Supportvertrag, der eine Fehlerbehebung zu einem für das Projekt relevanten Zeitpunkt garantiert.

IronBarcode Ansatz

IronBarcode teilt den SkiaSharp-Abhängigkeitsgraphen nicht mit dem Anwendungscode. Es gibt keine Versionsverhandlungen, die verwaltet werden müssen, keine NU1608-Fehlerdiagnose und kein Laufzeit-Assembly-Bindungsrisiko im Zusammenhang mit der SkiaSharp-Versionsauflösung. MAUI-Projekte, Blazor -Projekte und alle anderen Anwendungen, die von SkiaSharp abhängen, können IronBarcode ohne Versionskonflikte installieren. Für MAUI-spezifische Integrationsmuster siehe die IronBarcode MAUI-Dokumentation .

Leseanforderung erscheint

Ein System, das seit Monaten Versandetiketten generiert, erhält eine neue Anforderung: Die Anwendung muss nun auch von Lieferanten zurückgesendete Etiketten verarbeiten können. Die Lagerintegration muss Barcodes aus eingehenden Lieferscheinen auslesen können. Ein Dokumentenmanagementsystem muss Barcodes auf gescannten PDFs indexieren können. BarcodeLibkann keine dieser Anforderungen erfüllen – die Lese-API existiert nicht. Das Team prüft die Möglichkeit, ZXing .NET parallel zu BarcodeLibzu installieren, wägt den Wartungsaufwand für zwei Bibliotheken und die zwei separaten Abhängigkeitsgraphen ab und entscheidet sich schließlich für eine Bibliothek, die sowohl die Generierung als auch das Lesen mit einer einzigen NuGet Installation ermöglicht.

SkiaSharp-Konflikt in einem MAUI-Projekt

Ein Team fügt BarcodeLibzu einer bestehenden MAUI-Anwendung hinzu und stößt während der Wiederherstellung sofort auf NU1608-Warnungen. Sie untersuchen den Fehler, identifizieren die Versionsabweichung zwischen dem von BarcodeLiberwarteten SkiaSharp-Bereich und der von MAUI benötigten Version, fügen explizite <PackageReference>-Überschreibungen hinzu, um eine Lösung zu erzwingen, und bringen den Build zum Erfolg. Dann kommt es auf dem Gerät zu einem Laufzeitabsturz, wenn die nativen Binärdateien von SkiaSharp die falsche Version laden. Zur Behebung des Problems ist eine genauere Untersuchung des Assembly-Bindungsprotokolls erforderlich. Durch den Wechsel zu IronBarcode wird der Konflikt an der Wurzel beseitigt – nicht etwa durch das Finden einer kompatiblen SkiaSharp-Version, sondern durch die vollständige Eliminierung der gemeinsamen Abhängigkeit.

PDF-Barcode-Verarbeitung erforderlich

Anwendungen, die PDF-Dokumente mit eingebetteten Barcodes generieren – Rechnungen, Arbeitsaufträge, Versandmanifeste – müssen diese Barcodes manchmal bei der Weiterverarbeitung wieder einlesen. BarcodeLibgeneriert Barcode-Bilder, bietet aber auf keiner Seite PDF-Unterstützung. Das Einlesen von Barcodes aus einer PDF-Datei mit BarcodeLiberfordert, dass die PDF-Datei zunächst mithilfe einer separaten PDF-Bibliothek in Bilder umgewandelt wird, bevor diese Bilder an eine separate Lesebibliothek übergeben werden können. IronBarcode verarbeitet die gesamte Kette nativ: BarcodeReader.Read("file.pdf") durchläuft jede Seite und gibt alle erkannten Barcodes ohne einen Zwischenrendering-Schritt zurück.

Die Funktionen des QR-Codes übertreffen die der Basisgeneration.

Projekte, die anfänglich nur die einfache Generierung von QR-Codes erforderten, entwickeln sich oft weiter und benötigen dann die Einbettung eines Logos, die Anpassung der Farben oder die Konfiguration des Fehlerkorrekturniveaus. BarcodeLibunterstützt QR-Codes bis einschließlich TYPE.QR_Code, bietet aber keine Optionen über die Standardeigenschaften Width, Height und IncludeLabel hinaus. IronBarcodes QRCodeWriter ermöglicht das Einbetten von Logos, die Farbsteuerung und die Feinabstimmung der Fehlerkorrektur durch verkettete Methoden. Teams, deren Anforderungen an QR-Codes über die Möglichkeiten der Basisimplementierung von BarcodeLibhinausgehen, stellen fest, dass die Funktionslücke den Ausschlag für die Migration gibt.

Instanz-API zu statischer Fluent-API

Der Code von BarcodeLibverwendet ein veränderliches Objektmuster: Erstellen einer Barcode-Instanz, Festlegen von Eigenschaften, Aufruf von Encode(). IronBarcode verwendet ein statisches Fluent-Muster: Aufruf von BarcodeWriter.CreateBarcode(), Verkettung von Konfigurationsmethoden, Abschluss mit einer Ausgabemethode. Vorhandener Code, der eine Barcode-Instanz als Feld speichert oder sie zwischen Methoden übergibt, muss umstrukturiert werden. Die typische Änderung besteht darin, den Property-Setter-Block durch eine Methodenkette zu ersetzen:

// The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .AddAnnotationTextBelowBarcode(data)
    .SaveAsPng(outputPath);

// The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .AddAnnotationTextBelowBarcode(data)
    .SaveAsPng(outputPath);

System.Drawing.Image zu Direktausgabe

BarcodeLib gibt System.Drawing.Image zurück, wofür MemoryStream benötigt wird, um Bytes zu erzeugen. Jeder Code, der in Image oder System.Drawing.Image eingegeben wird, muss aktualisiert werden. Die flüssige Kette von IronBarcode endet direkt mit dem gewünschten Ausgabeformat — .SaveAsPng(), .ToPngBinaryData(), .ToAnyImageData() — wodurch die Notwendigkeit des Zwischenbildobjekts und des Schritts MemoryStream entfällt.

Typ-Enum zu BarcodeEncoding-Enum

BarcodeLib verwendet die Klasse TYPE mit Großbuchstabenkonstanten wie TYPE.CODE128. IronBarcode verwendet die Aufzählung BarcodeEncoding mit PascalCase-Werten wie z. B. BarcodeEncoding.Code128. Die Werte werden direkt zugeordnet. Eine Suche mit grep nach TYPE\. in .cs Dateien identifiziert alle Vorkommen, die aktualisiert werden müssen, und eine systematische Suche und Ersetzung deckt die gängigen Formate ab: CODE128 → Code128, EAN13 → EAN13, UPCA → UPCA, QR_Code → QRCode.

SkiaSharp Referenzbereinigung

Projekte, die explizite <PackageReference Include="SkiaSharp">-Einträge nur zur Behebung der NU1608-Warnungen von BarcodeLibhinzugefügt haben, können diese Überschreibungen nach dem Wechsel zu IronBarcode entfernen. Der Befehl dotnet list package --include-transitive prüft, ob SkiaSharp noch von anderen Paketen im Projekt benötigt wird, bevor es entfernt wird.