BarcodeLibCore-Generierungsmuster

Der standardmäßige BarcodeLib-Erstellungsvorgang erfordert das Erstellen einer Instanz, die Konfiguration von Eigenschaften und das Aufrufen von Encode() mit Maßen:

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();
b.IncludeLabel = true;
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

using var stream = File.OpenWrite("barcode.png");
img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream);

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();
b.IncludeLabel = true;
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

using var stream = File.OpenWrite("barcode.png");
img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream);

Imports BarcodeStandard
Imports SkiaSharp

Dim b As New Barcode()
b.IncludeLabel = True
Dim img As SKImage = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100)

Using stream = File.OpenWrite("barcode.png")
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream)
End Using

Dies ist der vollständige Generierungsablauf. Das Property-Setter-Muster ist das Design: Die Konfiguration erfolgt auf der Instanz vor dem Encode()-Aufruf, und der Rückgabewert ist ein SKImage, das kodiert und in einen Stream geschrieben werden muss.

Detaillierter Funktionsvergleich

BarcodeLib-Ansatz

BarcodeLib erfordert das Erstellen einer Instanz und das Setzen von Eigenschaften, bevor Encode() mit Dimensionen aufgerufen wird. Die Ausgabe ist ein SKImage:

using BarcodeStandard;
using SkiaSharp;

public byte[] GenerateCode128(string data)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    SKImage img = b.Encode(BarcodeStandard.Type.Code128, data, 300, 100);

    using var ms = new MemoryStream();
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms);
    return ms.ToArray();
}

using BarcodeStandard;
using SkiaSharp;

public byte[] GenerateCode128(string data)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    SKImage img = b.Encode(BarcodeStandard.Type.Code128, data, 300, 100);

    using var ms = new MemoryStream();
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms);
    return ms.ToArray();
}

Imports BarcodeStandard
Imports SkiaSharp

Public Function GenerateCode128(data As String) As Byte()
    Dim b As New Barcode()
    b.IncludeLabel = True
    Dim img As SKImage = b.Encode(BarcodeStandard.Type.Code128, data, 300, 100)

    Using ms As New MemoryStream()
        img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms)
        Return ms.ToArray()
    End Using
End Function

Der SKImage-Rückgabetyp bedeutet, dass die Byte-Array-Ausgabe einen SKEncodedImageFormat-Kodierungsaufruf und einen MemoryStream erfordert. Die IncludeLabel-Eigenschaft ist ein boolescher Schalter — BarcodeLibrendert die kodierte Datenzeichenfolge als sichtbares Etikett unter den 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)
        .AddBarcodeValueTextBelowBarcode()
        .ToPngBinaryData();
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

Imports IronBarCode

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

.ToPngBinaryData() gibt das Byte-Array direkt zurück — kein Zwischen-Image- oder MemoryStream-Objekt. .AddBarcodeValueTextBelowBarcode() rendert die kodierte Datenzeichenfolge als Etikett unter den Balken. 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. Lesen war nie Teil des Designs der Bibliothek. Jeder Versuch, eine Dekodierungsmethode aufzurufen, führt zu einem Kompilierungsfehler:

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();

// There is no Decode, Scan, or Read method on Barcode.
// b.Decode("barcode.png");      // does not exist
// b.Scan("barcode.png");        // does not exist
// b.ReadBarcode("barcode.png"); // does not exist

// The only public operation is generation:
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();

// There is no Decode, Scan, or Read method on Barcode.
// b.Decode("barcode.png");      // does not exist
// b.Scan("barcode.png");        // does not exist
// b.ReadBarcode("barcode.png"); // does not exist

// The only public operation is generation:
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

Imports BarcodeStandard
Imports SkiaSharp

Dim b = New Barcode()

' There is no Decode, Scan, or Read method on Barcode.
' b.Decode("barcode.png")      ' does not exist
' b.Scan("barcode.png")        ' does not exist
' b.ReadBarcode("barcode.png") ' does not exist

' The only public operation is generation:
Dim img As SKImage = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100)

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)

Das ReadingSpeed-Enum ermöglicht die Feinabstimmung der Scanleistung für Szenarien mit hohem Volumen. Hinweise zur Konfiguration des Lesevorgangs finden Sie in der IronBarcode -Lesedokumentation .

BarcodeLib-Ansatz

Ab BarcodeLib3.x führte die Bibliothek SkiaSharp als Grafik-Backend ein, um System.Drawing.Common zu ersetzen, das nach .NET 6 nur noch unter Windowsverwendet werden konnte. BarcodeLib3.1.5 erklärt SkiaSharp >= 2.88.8. Wenn ein Projekt bereits SkiaSharp über eine andere Abhängigkeit verwendet — was in MAUI-Projekten mit SkiaSharp.Views.Maui und Microsoft.Maui.Graphics häufig vorkommt, die zu SkiaSharp 3.x tendieren — können sich die aufgelösten Versionen nicht vereinbaren. Das Ergebnis ist mindestens eine NU1608-Warnung und schlimmstenfalls ein Assembly-Bindungsfehler zur Laufzeit:

warning NU1608: Detected package version outside of dependency constraint:
BarcodeLib 3.1.5 requires SkiaSharp (>= 2.88.8) but
version SkiaSharp 3.116.1 was resolved.

Eine Lösung zu erzwingen, indem man explizite Paketreferenzen verwendet, ist ein Weg, aber es gibt keine Garantie für Laufzeitkompatibilität:

<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 mit expliziten Überschreibungen hängt die Kompatibilität davon ab, dass die internen API-Aufrufe von BarcodeLibmit dem übereinstimmen, was die aufgelöste SkiaSharp-Version bereitstellt. Als von der Community gepflegtes Projekt hat BarcodeLibkeinen kommerziellen Support-Vertrag, der mit seinem Release-Rhythmus verbunden ist.

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 das Versionsmismatch zwischen dem erwarteten SkiaSharp-Bereich von BarcodeLibund der von MAUI benötigten Version, fügen explizite <PackageReference>-Überschreibungen hinzu, um eine Lösung zu erzwingen, und bringen den Build zum Bestehen. 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 behandelt die gesamte Kette nativ: BarcodeReader.Read("file.pdf") durchläuft jede Seite und gibt alle erkannten Barcodes ohne einen Zwischenschritt der Darstellung zurück.

QR-Code oder andere 2D-Symbologie-Anforderung erscheint

Projekte, die ursprünglich nur lineare Barcodes benötigten, entwickeln sich oft dahingehend, dass sie QR-Code, Data Matrix, PDF417 oder Aztec-Ausgabe benötigen. BarcodeLibgeneriert keine 2D-Symbologie in seiner 3.x-Serie — das BarcodeStandard.Type-Enum enthält keinen QR-Code oder andere 2D-Einträge — daher bedeutet jede 2D-Anforderung entweder die Hinzufügung einer zweiten Bibliothek oder den vollständigen Ersatz von BarcodeLib. IronBarcode's QRCodeWriter und BarcodeWriter decken QR-Code (mit Logo-Einbettung, Farbsteuerung und Fehlerkorrektur-Anpassung), Data Matrix, PDF417 und Aztec über die gleiche Fluent-API ab. Teams, deren Symbologie-Anforderungen in 2D übergehen, stellen fest, dass die Lücke die Migrationsentscheidung antreibt.

Instanz-API zu statischer Fluent-API

BarcodeLib-Code verwendet ein veränderliches Objektmuster: erstellen Sie eine Barcode-Instanz, setzen Sie Eigenschaften, rufen Sie Encode() auf. IronBarcode verwendet ein statisches Fluent-Muster: Rufen Sie BarcodeWriter.CreateBarcode() auf, verketten Sie Konfigurationsmethoden, beenden Sie mit einer Ausgabemethode. Vorhandener Code, der eine Barcode-Instanz als Feld speichert oder zwischen Methoden übergibt, muss neu strukturiert 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)
    .AddBarcodeValueTextBelowBarcode()
    .SaveAsPng(outputPath);

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

' The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
    .ResizeTo(300, 100) _
    .AddBarcodeValueTextBelowBarcode() _
    .SaveAsPng(outputPath)

SKImage zu direkter Ausgabe

BarcodeLib 3.x gibt SKImage zurück, das SKEncodedImageFormat und einen Stream benötigt, um Bytes zu erzeugen. Jeder Code, der auf SKImage typisiert ist oder durch image.Encode(...).SaveTo(stream) geht, muss aktualisiert werden. Die Fluent-Kette von IronBarcode endet direkt mit dem gewünschten Ausgabeformat — .SaveAsPng(), .ToPngBinaryData(), .ToAnyImageData() — und entfernt die Notwendigkeit für das Zwischenabbildobjekt und den Kodierungs-zu-Stream-Schritt.

Type Enum to BarcodeEncoding Enum

BarcodeLib 3.x verwendet das BarcodeStandard.Type-Enum mit PascalCase-Werten wie BarcodeStandard.Type.Code128. IronBarcode verwendet das BarcodeEncoding-Enum mit Werten wie BarcodeEncoding.Code128. Die 1D-Werte werden direkt zugeordnet: Code128 → Code128, Ean13 → EAN13, UpcA → UPCA, Code39 → Code39. Ein grep für BarcodeStandard.Type. über .cs-Dateien identifiziert alle Vorkommen, die aktualisiert werden müssen.

SkiaSharp Referenzbereinigung

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