Das grundsätzliche Problem

MessagingToolkit.Barcode erzwingt eine Abhängigkeit von System.Drawing und einem instanzbasierten Workflow, der mit modernen .NET-Versionen inkompatibel ist:

// MessagingToolkit.Barcode: only compiles on .NET Framework 4.5 or earlier
// System.Drawing.Bitmap throws PlatformNotSupportedException on Linux/.NET 6+
using MessagingToolkit.Barcode;
using System.Drawing;

var decoder = new BarcodeDecoder();
using (var bitmap = new Bitmap("barcode.png"))  // Windows-only in .NET 6+
{
    var result = decoder.Decode(bitmap);          // Single result or null
    if (result != null)
    {
        Console.WriteLine(result.Text);
    }
}

// MessagingToolkit.Barcode: only compiles on .NET Framework 4.5 or earlier
// System.Drawing.Bitmap throws PlatformNotSupportedException on Linux/.NET 6+
using MessagingToolkit.Barcode;
using System.Drawing;

var decoder = new BarcodeDecoder();
using (var bitmap = new Bitmap("barcode.png"))  // Windows-only in .NET 6+
{
    var result = decoder.Decode(bitmap);          // Single result or null
    if (result != null)
    {
        Console.WriteLine(result.Text);
    }
}

Imports MessagingToolkit.Barcode
Imports System.Drawing

Dim decoder As New BarcodeDecoder()
Using bitmap As New Bitmap("barcode.png") ' Windows-only in .NET 6+
    Dim result = decoder.Decode(bitmap) ' Single result or Nothing
    If result IsNot Nothing Then
        Console.WriteLine(result.Text)
    End If
End Using

IronBarcode entfernt die System.Drawing-Abhängigkeit vollständig und funktioniert identisch auf Windows, Linux, macOS und Docker-Containern:

// IronBarcode: runs on .NET 6, 7, 8, 9 — Windows, Linux, macOS, Docker
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

var results = BarcodeReader.Read("barcode.png");  //NeinBitmap, no System.Drawing
foreach (var result in results)
{
    Console.WriteLine(result.Value);
}

// IronBarcode: runs on .NET 6, 7, 8, 9 — Windows, Linux, macOS, Docker
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

var results = BarcodeReader.Read("barcode.png");  //NeinBitmap, no System.Drawing
foreach (var result in results)
{
    Console.WriteLine(result.Value);
}

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Dim results = BarcodeReader.Read("barcode.png") 'NeinBitmap, no System.Drawing
For Each result In results
    Console.WriteLine(result.Value)
Next

Schritt 1: Ersetzen des NuGet-Pakets

Entfernen Sie das Paket MessagingToolkit.Barcode:

dotnet remove package MessagingToolkit.Barcode

dotnet remove package MessagingToolkit.Barcode

Falls das Projekt MessagingToolkit.Barcode.dll direkt über einen <HintPath>-Eintrag in der .csproj-Datei referenziert, entfernen Sie auch diese Referenz.

IronBarcode installieren:

dotnet add package IronBarcode

dotnet add package IronBarcode

IronBarcode unterstützt .NET Framework 4.6.2 bis .NET 9. Es wird als einzelnes Paket mit allen gebündelten Abhängigkeiten installiert – es wird keine separate Grafikbibliothek oder ZXing-Referenz benötigt.

Schritt 2: Namespaces aktualisieren

Ersetzen Sie den MessagingToolkit-Namespace in jeder Datei, die auf die alte Bibliothek verweist, durch den IronBarcode-Namespace:

// Remove this
using MessagingToolkit.Barcode;
using System.Drawing;  // if used only for Bitmap input to MessagingToolkit

// Add this
using IronBarCode;

// Remove this
using MessagingToolkit.Barcode;
using System.Drawing;  // if used only for Bitmap input to MessagingToolkit

// Add this
using IronBarCode;

Imports IronBarCode

Dateien, die System.Drawing ausschließlich für den Bitmap-Typ importierten, der mit MessagingToolkit.Barcode verwendet wurde, können diesen Import entfernen, sobald IronBarcode im Einsatz ist.

Schritt 3: Lizenz initialisieren

Fügen Sie die Lizenzinitialisierung einmal beim Start der Anwendung hinzu - in Program.cs, Startup.cs oder dem entsprechenden Einstiegspunkt. Für den Produktiveinsatz ist ein Lizenzschlüssel erforderlich; Die Bibliothek arbeitet im Testmodus ohne ein solches Exemplar.

// Add once at application startup
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Add once at application startup
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

' Add once at application startup
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Barcodes aus Bilddateien lesen

Der alte Ansatz erforderte die Konstruktion eines Bitmap aus dem Dateipfad und übergab ihn an eine BarcodeDecoder-Instanz. IronBarcode akzeptiert den Dateipfad direkt.

MessagingToolkit.Barcode-Ansatz:

using MessagingToolkit.Barcode;
using System.Drawing;

public string ReadBarcodeValue(string imagePath)
{
    var decoder = new BarcodeDecoder();
    using (var bitmap = new Bitmap(imagePath))
    {
        var result = decoder.Decode(bitmap);
        return result?.Text;
    }
}

using MessagingToolkit.Barcode;
using System.Drawing;

public string ReadBarcodeValue(string imagePath)
{
    var decoder = new BarcodeDecoder();
    using (var bitmap = new Bitmap(imagePath))
    {
        var result = decoder.Decode(bitmap);
        return result?.Text;
    }
}

Imports MessagingToolkit.Barcode
Imports System.Drawing

Public Function ReadBarcodeValue(imagePath As String) As String
    Dim decoder As New BarcodeDecoder()
    Using bitmap As New Bitmap(imagePath)
        Dim result = decoder.Decode(bitmap)
        Return If(result IsNot Nothing, result.Text, Nothing)
    End Using
End Function

IronBarcode -Ansatz:

using IronBarCode;

public string ReadBarcodeValue(string imagePath)
{
    var results = BarcodeReader.Read(imagePath);
    return results.FirstOrDefault()?.Value;
}

using IronBarCode;

public string ReadBarcodeValue(string imagePath)
{
    var results = BarcodeReader.Read(imagePath);
    return results.FirstOrDefault()?.Value;
}

Imports IronBarCode

Public Function ReadBarcodeValue(imagePath As String) As String
    Dim results = BarcodeReader.Read(imagePath)
    Return results.FirstOrDefault()?.Value
End Function

Die IronBarcode-Version entfernt die Bitmap-Konstruktion und das null-bedingte Muster bei einem einzelnen Objekt. BarcodeReader.Read() gibt eine Sammlung zurück – eine leere Sammlung, wenn nichts gefunden wird – sodass .FirstOrDefault() die Nullüberprüfung des alten Einzelwert-Rückgabewerts ersetzt.

Zugriff auf Formatinformationen aus den Ergebnissen

MessagingToolkit.Barcode legte das erkannte Format über result.BarcodeFormat offen. IronBarcode macht es über result.Format zugänglich. Beide sind Enum-Werte im Ergebnisobjekt, jedoch mit unterschiedlichen Enum-Typnamen.

MessagingToolkit.Barcode-Ansatz:

using MessagingToolkit.Barcode;
using System.Drawing;

var decoder = new BarcodeDecoder();
using (var bitmap = new Bitmap("barcode.png"))
{
    var result = decoder.Decode(bitmap);
    if (result != null)
    {
        Console.WriteLine($"Value: {result.Text}");
        Console.WriteLine($"Format: {result.BarcodeFormat}");
    }
}

using MessagingToolkit.Barcode;
using System.Drawing;

var decoder = new BarcodeDecoder();
using (var bitmap = new Bitmap("barcode.png"))
{
    var result = decoder.Decode(bitmap);
    if (result != null)
    {
        Console.WriteLine($"Value: {result.Text}");
        Console.WriteLine($"Format: {result.BarcodeFormat}");
    }
}

Imports MessagingToolkit.Barcode
Imports System.Drawing

Dim decoder As New BarcodeDecoder()
Using bitmap As New Bitmap("barcode.png")
    Dim result = decoder.Decode(bitmap)
    If result IsNot Nothing Then
        Console.WriteLine($"Value: {result.Text}")
        Console.WriteLine($"Format: {result.BarcodeFormat}")
    End If
End Using

IronBarcode -Ansatz:

using IronBarCode;

var results = BarcodeReader.Read("barcode.png");
var first = results.FirstOrDefault();
if (first != null)
{
    Console.WriteLine($"Value: {first.Value}");
    Console.WriteLine($"Format: {first.Format}");
}

using IronBarCode;

var results = BarcodeReader.Read("barcode.png");
var first = results.FirstOrDefault();
if (first != null)
{
    Console.WriteLine($"Value: {first.Value}");
    Console.WriteLine($"Format: {first.Format}");
}

Imports IronBarCode

Dim results = BarcodeReader.Read("barcode.png")
Dim first = results.FirstOrDefault()
If first IsNot Nothing Then
    Console.WriteLine($"Value: {first.Value}")
    Console.WriteLine($"Format: {first.Format}")
End If

Der Eigenschaftenname ändert sich von .Text zu .Value und von .BarcodeFormat zu .Format. Der Enum-Typ ändert sich von BarcodeFormat (MessagingToolkit) zu BarcodeEncoding (IronBarcode), obwohl .Format.ToString() eine vergleichbare, menschenlesbare Zeichenkette für Anzeige- oder Protokollierungszwecke erzeugt.

Barcodes generieren

MessagingToolkit.Barcode verwendete ein instanzbasiertes BarcodeEncoder mit einem Property-Set-Format, bevor .Encode() aufgerufen wurde. IronBarcode verwendet eine statische Methode, die den Kodierungstyp als Parameter entgegennimmt.

MessagingToolkit.Barcode-Ansatz:

using MessagingToolkit.Barcode;

public void GenerateQrCode(string data, string outputPath)
{
    var encoder = new BarcodeEncoder();
    encoder.Format = BarcodeFormat.QrCode;
    var bitmap = encoder.Encode(data);
    bitmap.Save(outputPath);
}

using MessagingToolkit.Barcode;

public void GenerateQrCode(string data, string outputPath)
{
    var encoder = new BarcodeEncoder();
    encoder.Format = BarcodeFormat.QrCode;
    var bitmap = encoder.Encode(data);
    bitmap.Save(outputPath);
}

Imports MessagingToolkit.Barcode

Public Sub GenerateQrCode(data As String, outputPath As String)
    Dim encoder As New BarcodeEncoder()
    encoder.Format = BarcodeFormat.QrCode
    Dim bitmap = encoder.Encode(data)
    bitmap.Save(outputPath)
End Sub

IronBarcode -Ansatz:

using IronBarCode;

public void GenerateQrCode(string data, string outputPath)
{
    BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode)
        .SaveAsPng(outputPath);
}

using IronBarCode;

public void GenerateQrCode(string data, string outputPath)
{
    BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode)
        .SaveAsPng(outputPath);
}

Imports IronBarCode

Public Sub GenerateQrCode(data As String, outputPath As String)
    BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode) _
        .SaveAsPng(outputPath)
End Sub

Für die Erstellung von Code 128 und anderen 1D-Barcodes gilt dasselbe statische Muster mit einer anderen Codierungskonstante:

// Code 128
BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .SaveAsPng("code128.png");

// EAN-13
BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("ean13.png");

// Code 128
BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .SaveAsPng("code128.png");

// EAN-13
BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("ean13.png");

' Code 128
BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128) _
    .SaveAsPng("code128.png")

' EAN-13
BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13) _
    .SaveAsPng("ean13.png")

Aktualisierung des Zielrahmens

Sobald MessagingToolkit.Barcode entfernt und alle Verweise ersetzt wurden, kann das Zielframework der Projektdatei aktualisiert werden. Diese Änderung wurde durch die alte Abhängigkeit verhindert und wird erst nach deren Entfernung möglich:

MessagingToolkit.Barcode-Ansatz (Projektdatei):

<PropertyGroup>
  <TargetFramework>net472</TargetFramework>
</PropertyGroup>

<PropertyGroup>
  <TargetFramework>net472</TargetFramework>
</PropertyGroup>

IronBarcode Ansatz (Projektdatei):

<PropertyGroup>
  <TargetFramework>net8.0</TargetFramework>
</PropertyGroup>

<PropertyGroup>
  <TargetFramework>net8.0</TargetFramework>
</PropertyGroup>

IronBarcode unterstützt .NET Framework 4.6.2 bis .NET 9, sodass es vor dem Abschluss des Framework-Upgrades installiert werden kann. Dadurch kann die Migration schrittweise durchgeführt werden: IronBarcode wird zusammen mit MessagingToolkit.Barcode installiert, alle Verwendungen werden ersetzt, der neue Code wird überprüft, das alte Paket wird entfernt und als letzter Schritt das Zielframework geändert.

Barcodes aus PDF-Dokumenten lesen

MessagingToolkit.Barcode bot keine PDF-Unterstützung. Das Auslesen von Barcodes aus einer PDF-Datei erforderte das Extrahieren von Bildern aus jeder Seite mithilfe einer separaten Bibliothek, bevor der Barcode-Decoder aufgerufen werden konnte. IronBarcode liest PDF-Dateien direkt mit der gleichen Methode, die auch für Bilder verwendet wird.

MessagingToolkit.Barcode-Ansatz:

// Not supported — required external PDF page extraction before decode
//Neinequivalent exists in MessagingToolkit.Barcode

// Not supported — required external PDF page extraction before decode
//Neinequivalent exists in MessagingToolkit.Barcode

' Not supported — required external PDF page extraction before decode
' No equivalent exists in MessagingToolkit.Barcode

IronBarcode -Ansatz:

using IronBarCode;

// Read all barcodes from every page of a PDF document
var results = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value} ({barcode.Format})");
}

using IronBarCode;

// Read all barcodes from every page of a PDF document
var results = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value} ({barcode.Format})");
}

Imports IronBarCode

' Read all barcodes from every page of a PDF document
Dim results = BarcodeReader.Read("invoice.pdf")
For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value} ({barcode.Format})")
Next

Anwendungen, die gescannte Dokumente, Versandmanifeste oder mehrseitige Rechnungsstapel verarbeiten, erhalten diese Funktionalität im Rahmen der Migration ohne zusätzliche Bibliothek oder Konfiguration.

Problem 1: Namespace nach Paketaktualisierung nicht gefunden

Problem: Nach dem Entfernen von MessagingToolkit.Barcode und dem Hinzufügen von IronBarcode schlägt die Kompilierung mit CS0246: The type or namespace name 'BarcodeDecoder' could not be found fehl.

Lösung: Der alte Namespace using MessagingToolkit.Barcode; muss durch using IronBarCode; (beachten Sie das große C) in jeder Datei ersetzt werden, die die alte Bibliothek referenziert. Eine projektweite Suche nach der alten Namespace-Zeichenfolge findet alle betroffenen Dateien:

grep -r "using MessagingToolkit.Barcode" --include="*.cs" .
grep -r "BarcodeDecoder\|BarcodeEncoder" --include="*.cs" .

grep -r "using MessagingToolkit.Barcode" --include="*.cs" .
grep -r "BarcodeDecoder\|BarcodeEncoder" --include="*.cs" .

Problem 2: Mehrdeutigkeit von BarcodeReadern zwischen Namensräumen

Problem: Wenn ein Projekt sowohl MessagingToolkit.Barcode als auch IronBarcode während einer gestuften Migration referenziert, kann BarcodeReader zwischen den beiden Namespaces mehrdeutig sein.

Lösung: Die Referenz während der Übergangszeit explizit qualifizieren:

// Use the fully qualified name while both packages are installed
var results = IronBarCode.BarcodeReader.Read("barcode.png");

// Use the fully qualified name while both packages are installed
var results = IronBarCode.BarcodeReader.Read("barcode.png");

Imports IronBarCode

Dim results = BarcodeReader.Read("barcode.png")

Sobald alle Referenzen auf MessagingToolkit.Barcode ersetzt und das alte Paket entfernt wurden, kann der Qualifizierer weggelassen werden und die using IronBarCode;-Direktive ist ausreichend.

Problem 3: Zielframework nach Paketentfernung weiterhin auf net472 eingestellt

Problem: Nach dem Entfernen von MessagingToolkit.Barcode und der Installation von IronBarcode zielt die Projektdatei immer noch auf net472. Build-Warnungen weisen darauf hin, dass moderne .NET -APIs nicht verfügbar sind.

Lösung: Aktualisieren Sie das <TargetFramework>-Element in der .csproj-Datei, sobald die Abhängigkeit entfernt wurde. IronBarcode unterstützt sowohl net472 (über .NET Framework 4.6.2 Kompatibilität) als auch moderne Ziele. Der Wechsel zu net8.0 erfordert die Überprüfung, dass keine anderen alten Abhängigkeiten im Projekt verbleiben:

<TargetFramework>net8.0</TargetFramework>

<TargetFramework>net8.0</TargetFramework>

Führen Sie dotnet build nach der Änderung aus, um verbleibende alte Abhängigkeiten zu identifizieren, die behoben werden müssen.

Vor der Migration anfallende Aufgaben

Überprüfen Sie den Quellcode, um alle Stellen zu identifizieren, die auf MessagingToolkit.Barcode verweisen:

# Find all using statements
grep -r "using MessagingToolkit.Barcode" --include="*.cs" .

# Find decoder instantiations
grep -r "BarcodeDecoder" --include="*.cs" .

# Find encoder instantiations
grep -r "BarcodeEncoder" --include="*.cs" .

# Find decode calls
grep -r "\.Decode(" --include="*.cs" .

# Find encode calls
grep -r "\.Encode(" --include="*.cs" .

# Find project file references
grep -r "MessagingToolkit" --include="*.csproj" .
grep -r "MessagingToolkit" --include="packages.config" .

# Find all using statements
grep -r "using MessagingToolkit.Barcode" --include="*.cs" .

# Find decoder instantiations
grep -r "BarcodeDecoder" --include="*.cs" .

# Find encoder instantiations
grep -r "BarcodeEncoder" --include="*.cs" .

# Find decode calls
grep -r "\.Decode(" --include="*.cs" .

# Find encode calls
grep -r "\.Encode(" --include="*.cs" .

# Find project file references
grep -r "MessagingToolkit" --include="*.csproj" .
grep -r "MessagingToolkit" --include="packages.config" .

Dokumentieren Sie alle Dateien, die Änderungen erfordern. Notieren Sie alle Orte, an denen System.Drawing.Bitmap als Eingabe für den Decoder verwendet wird – diese Verwendungen müssen ebenfalls aktualisiert werden.

Aufgaben der Code-Aktualisierung

1. Führen Sie dotnet remove package MessagingToolkit.Barcode aus, um das Paket zu entfernen
2. Führen Sie dotnet add package IronBarcode aus, um IronBarcode zu installieren
3. Fügen Sie IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"; beim Start der Anwendung hinzu
4. Ersetzen Sie alle using MessagingToolkit.Barcode;-Anweisungen durch using IronBarCode;
5. Ersetzen Sie alle new BarcodeDecoder()-Muster durch BarcodeReader.Read()-statische Aufrufe
6. Ersetzen Sie alle new BarcodeEncoder()-Muster durch BarcodeWriter.CreateBarcode()-statische Aufrufe
7. Aktualisieren Sie alle result.Text-Referenzen auf result.Value
8. Aktualisieren Sie alle result.BarcodeFormat-Referenzen auf result.Format
9. Aktualisieren Sie alle barcodeWriter.Format = BarcodeFormat.X-Muster, um die Codierung als Parameter zu übergeben
10. Ersetzen Sie bitmap.Save() durch .SaveAsPng() oder die entsprechende Ausgabemethode auf dem IronBarcode-Ergebnis
11. Entfernen Sie using System.Drawing;-Importe, wo sie nur für Bitmap-Eingaben auf MessagingToolkit verwendet wurden
12. Aktualisieren Sie <TargetFramework> in der Projektdatei, wenn ein Framework-Upgrade Teil der Migration ist

Post-Migrationstests

• Überprüfen Sie, dass dotnet build mit null Fehlern und null Referenzen auf MessagingToolkit abgeschlossen wird
• Führen Sie grep -r "MessagingToolkit" --include="*.cs" . aus und bestätigen Sie null Ergebnisse
• Testen Sie das Barcode-Lesen mit echten Barcode-Bildern aus Ihrer Anwendung und bestätigen Sie, dass .Value den erwarteten String zurückgibt
• Testen Sie das Lesen von Barcodes mit Bildern mehrerer Barcodes und bestätigen Sie, dass alle Barcodes in der Sammlung zurückgegeben werden.
• Testen Sie die Barcode-Generierung und überprüfen Sie, ob die Ausgabedatei dem erwarteten Format und der erwarteten Kodierung entspricht.
• Falls die PDF-Lesefunktion verwendet wird, testen Sie diese mit einem repräsentativen PDF-Dokument und überprüfen Sie, ob die Metadaten der Seitenzahlen korrekt sind.
• Wurde das Zielframework geändert, führen Sie die vollständige Suite in der neuen Laufzeitumgebung aus, um weitere Kompatibilitätsprobleme zu identifizieren.