Das grundsätzliche Problem

QRCoder löst das Problem der QR-Generierung auf effiziente Weise. Sobald eine Anforderung die QR-Kriterien überschreitet, muss die Codebasis zusätzliche Pakete einbinden, um jede Lücke zu füllen:

// QR-Code handles QR generation well — but no further
using QRCoder;
using System.IO;

var generator = new QRCodeGenerator();
var qrCodeData = generator.CreateQrCode("SHIP-12345", QRCodeGenerator.ECCLevel.M);
var qrCode = new PngByteQRCode(qrCodeData);
File.WriteAllBytes("qr.png", qrCode.GetGraphic(10));

// Now the shipping team asks for Code 128 — add NetBarcode
// Now the warehouse needs to scan barcodes — add ZXing.Net
// Now a report needs a barcode in a PDF — add a PDF library
// Each addition: new namespace, new API, new maintenance cycle

// QR-Code handles QR generation well — but no further
using QRCoder;
using System.IO;

var generator = new QRCodeGenerator();
var qrCodeData = generator.CreateQrCode("SHIP-12345", QRCodeGenerator.ECCLevel.M);
var qrCode = new PngByteQRCode(qrCodeData);
File.WriteAllBytes("qr.png", qrCode.GetGraphic(10));

// Now the shipping team asks for Code 128 — add NetBarcode
// Now the warehouse needs to scan barcodes — add ZXing.Net
// Now a report needs a barcode in a PDF — add a PDF library
// Each addition: new namespace, new API, new maintenance cycle

Imports QRCoder
Imports System.IO

Dim generator As New QRCodeGenerator()
Dim qrCodeData = generator.CreateQrCode("SHIP-12345", QRCodeGenerator.ECCLevel.M)
Dim qrCode As New PngByteQRCode(qrCodeData)
File.WriteAllBytes("qr.png", qrCode.GetGraphic(10))

' Now the shipping team asks for Code 128 — add NetBarcode
' Now the warehouse needs to scan barcodes — add ZXing.Net
' Now a report needs a barcode in a PDF — add a PDF library
' Each addition: new namespace, new API, new maintenance cycle

IronBarcode vereint Generierung, Lesen und PDF-Integration unter einer einzigen API:

// IronBarcode — one library covers all of the above
using IronBarCode;

// Generate QR
BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

// Generate Code 128 — same API
BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128)
    .SaveAsPng("label.png");

// Read a barcode from an image — built in
var results = BarcodeReader.Read("incoming.png");

// IronBarcode — one library covers all of the above
using IronBarCode;

// Generate QR
BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

// Generate Code 128 — same API
BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128)
    .SaveAsPng("label.png");

// Read a barcode from an image — built in
var results = BarcodeReader.Read("incoming.png");

Imports IronBarCode

' Generate QR
BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.QRCode) _
    .SaveAsPng("qr.png")

' Generate Code 128 — same API
BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128) _
    .SaveAsPng("label.png")

' Read a barcode from an image — built in
Dim results = BarcodeReader.Read("incoming.png")

Schritt 1: Ersetzen des NuGet-Pakets

QRCoder aus dem Projekt entfernen:

dotnet remove package QRCoder

dotnet remove package QRCoder

IronBarcode installieren:

dotnet add package IronBarcode

dotnet add package IronBarcode

Falls im Projekt ZXing .NET zusammen mit QR-Code zum Einlesen von Barcodes verwendet wurde, kann dieses Paket ebenfalls in diesem Stadium entfernt werden:

dotnet remove package ZXing.Net

dotnet remove package ZXing.Net

Schritt 2: Namespaces aktualisieren

Ersetzen Sie den Import des QRCoder-Namensraums durch den IronBarcode Namensraum:

// Before (QRCoder)
using QRCoder;

// After (IronBarcode)
using IronBarCode;

// Before (QRCoder)
using QRCoder;

// After (IronBarcode)
using IronBarCode;

' Before (QRCoder)
Imports QRCoder

' After (IronBarcode)
Imports IronBarCode

Schritt 3: Lizenz initialisieren

Lizenzinitialisierung beim Anwendungsstart hinzufügen — Program.cs, Startup.cs oder ein statischer Konstruktor:

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

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

Imports IronBarCode

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

Ein kostenloser Testschlüssel ist ohne Registrierung erhältlich. Für den Einsatz in Produktionsumgebungen ist eine erworbene Lizenz erforderlich.

Grundlegende QR-Code-Generierung

Das häufigste QRCoder-Muster erfordert drei Objekte: eine QRCodeGenerator-Instanz, ein QRCodeData-Zwischenobjekt und eine Renderer-Klasse wie PngByteQRCode. In IronBarcode wird diese Kette durch einen einzigen statischen Aufruf ersetzt.

QRCoder-Ansatz:

using QRCoder;

public class BarcodeService
{
    private readonly QRCodeGenerator _generator = new QRCodeGenerator();

    public byte[] GenerateQR(string content)
    {
        var qrCodeData = _generator.CreateQrCode(content, QRCodeGenerator.ECCLevel.M);
        var qrCode = new PngByteQRCode(qrCodeData);
        return qrCode.GetGraphic(10); // 10px per module
    }
}

using QRCoder;

public class BarcodeService
{
    private readonly QRCodeGenerator _generator = new QRCodeGenerator();

    public byte[] GenerateQR(string content)
    {
        var qrCodeData = _generator.CreateQrCode(content, QRCodeGenerator.ECCLevel.M);
        var qrCode = new PngByteQRCode(qrCodeData);
        return qrCode.GetGraphic(10); // 10px per module
    }
}

Imports QRCoder

Public Class BarcodeService
    Private ReadOnly _generator As New QRCodeGenerator()

    Public Function GenerateQR(content As String) As Byte()
        Dim qrCodeData = _generator.CreateQrCode(content, QRCodeGenerator.ECCLevel.M)
        Dim qrCode = New PngByteQRCode(qrCodeData)
        Return qrCode.GetGraphic(10) ' 10px per module
    End Function
End Class

IronBarcode -Ansatz:

using IronBarCode;

public class BarcodeService
{
    public byte[] GenerateQR(string content)
    {
        return BarcodeWriter.CreateBarcode(content, BarcodeEncoding.QRCode)
            .ResizeTo(200, 200)
            .ToPngBinaryData();
    }
}

using IronBarCode;

public class BarcodeService
{
    public byte[] GenerateQR(string content)
    {
        return BarcodeWriter.CreateBarcode(content, BarcodeEncoding.QRCode)
            .ResizeTo(200, 200)
            .ToPngBinaryData();
    }
}

Imports IronBarCode

Public Class BarcodeService
    Public Function GenerateQR(content As String) As Byte()
        Return BarcodeWriter.CreateBarcode(content, BarcodeEncoding.QRCode) _
            .ResizeTo(200, 200) _
            .ToPngBinaryData()
    End Function
End Class

BarcodeWriter ist eine statische Klasse — keine Instanz wird benötigt und es gibt kein Zwischenobjekt. Die ResizeTo(width, height)-Methode ersetzt die Pixel-pro-Modul-Ganzzahl, die QR-Code in GetGraphic akzeptiert. Wo QR-Code die Ausgabe durch die Anzahl der Module bestimmt (z.B. GetGraphic(10) für ein 10px pro Modul Bild), nimmt IronBarcode absolute Pixelmaße.

QR-Codes in Datei speichern

QRCoder trennt die Bytes im Arbeitsspeicher von der Dateiausgabe erst im letzten Schritt – die Rendererkette bleibt dabei gleich. IronBarcode verwendet auf derselben Kette unterschiedliche Terminalmethoden.

QRCoder-Ansatz:

using QRCoder;
using System.IO;

var generator = new QRCodeGenerator();
var qrCodeData = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M);
var pngBytes = new PngByteQRCode(qrCodeData).GetGraphic(10);
File.WriteAllBytes("output.png", pngBytes);

using QRCoder;
using System.IO;

var generator = new QRCodeGenerator();
var qrCodeData = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M);
var pngBytes = new PngByteQRCode(qrCodeData).GetGraphic(10);
File.WriteAllBytes("output.png", pngBytes);

Imports QRCoder
Imports System.IO

Dim generator As New QRCodeGenerator()
Dim qrCodeData = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M)
Dim pngBytes = New PngByteQRCode(qrCodeData).GetGraphic(10)
File.WriteAllBytes("output.png", pngBytes)

IronBarcode -Ansatz:

using IronBarCode;

// Save directly — no intermediate byte array needed
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .ResizeTo(300, 300)
    .SaveAsPng("output.png");

// Or obtain bytes for in-memory use
byte[] pngBytes = BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .ResizeTo(300, 300)
    .ToPngBinaryData();

using IronBarCode;

// Save directly — no intermediate byte array needed
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .ResizeTo(300, 300)
    .SaveAsPng("output.png");

// Or obtain bytes for in-memory use
byte[] pngBytes = BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .ResizeTo(300, 300)
    .ToPngBinaryData();

Imports IronBarCode

' Save directly — no intermediate byte array needed
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .ResizeTo(300, 300) _
    .SaveAsPng("output.png")

' Or obtain bytes for in-memory use
Dim pngBytes As Byte() = BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .ResizeTo(300, 300) _
    .ToPngBinaryData()

Die SaveAsPng-Methode ist ein Terminal, das direkt auf die Festplatte schreibt. ToPngBinaryData gibt ein byte[] zurück für Streaming, HTTP-Antworten oder Datenbankspeicherung.

SVG-Ausgabe

QRCoder-Ansatz:

using QRCoder;
using System.IO;

var generator = new QRCodeGenerator();
var qrCodeData = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M);
string svgContent = new SvgQRCode(qrCodeData).GetGraphic(10);
File.WriteAllText("output.svg", svgContent);

using QRCoder;
using System.IO;

var generator = new QRCodeGenerator();
var qrCodeData = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M);
string svgContent = new SvgQRCode(qrCodeData).GetGraphic(10);
File.WriteAllText("output.svg", svgContent);

Imports QRCoder
Imports System.IO

Dim generator As New QRCodeGenerator()
Dim qrCodeData = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M)
Dim svgContent As String = New SvgQRCode(qrCodeData).GetGraphic(10)
File.WriteAllText("output.svg", svgContent)

IronBarcode -Ansatz:

using IronBarCode;

BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsImage("output.svg");

using IronBarCode;

BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsImage("output.svg");

Imports IronBarCode

BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .SaveAsImage("output.svg")

Die SvgQRCode-Rendererklasse und ihr GetGraphic-Aufruf lassen sich zu einer einzigen SaveAsImage-Terminalmethode zusammenfassen (eine .svg-Erweiterung erzeugt SVG-Ausgabe).

Zuordnung der Fehlerkorrekturstufen

QRCoder erfordert eine explizite ECC-Auswahl bei jedem CreateQrCode-Aufruf mit dem QRCodeGenerator.ECCLevel-Enum. IronBarcode wendet einen sinnvollen Standardwert an, wenn BarcodeWriter.CreateBarcode verwendet wird, und bietet explizite Kontrolle über QRCodeWriter.QrErrorCorrectionLevel.

QRCoder-Ansatz:

using QRCoder;

var generator = new QRCodeGenerator();

// Medium — suitable for most generation without logos
var dataMedium = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M);

// High — required when a logo will occlude part of the code
var dataHigh = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.H);

using QRCoder;

var generator = new QRCodeGenerator();

// Medium — suitable for most generation without logos
var dataMedium = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M);

// High — required when a logo will occlude part of the code
var dataHigh = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.H);

Imports QRCoder

Dim generator As New QRCodeGenerator()

' Medium — suitable for most generation without logos
Dim dataMedium = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M)

' High — required when a logo will occlude part of the code
Dim dataHigh = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.H)

IronBarcode -Ansatz:

using IronBarCode;

// Default — equivalent to Medium, applied automatically
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("default-ecc.png");

// Explicit level via QRCodeWriter
var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Highest
);
qr.SaveAsPng("high-ecc.png");

using IronBarCode;

// Default — equivalent to Medium, applied automatically
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("default-ecc.png");

// Explicit level via QRCodeWriter
var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Highest
);
qr.SaveAsPng("high-ecc.png");

Imports IronBarCode

' Default — equivalent to Medium, applied automatically
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .SaveAsPng("default-ecc.png")

' Explicit level via QRCodeWriter
Dim qr = QRCodeWriter.CreateQrCode( _
    "https://example.com", _
    500, _
    QRCodeWriter.QrErrorCorrectionLevel.Highest _
)
qr.SaveAsPng("high-ecc.png")

Die Zuordnung der Ebenen ist: ECCLevel.L → Low, ECCLevel.M → Medium, ECCLevel.Q → High, ECCLevel.H → Highest.

Logoeinbettung

Beide Bibliotheken unterstützen das Einbetten von Logos in QR-Codes. QR-Code leitet dies über die QRCode-Rendererklasse (nicht PngByteQRCode) mit System.Drawing.Bitmap-Parametern. IronBarcode bietet QRCodeWriter.CreateQrCodeWithLogo() als dedizierte Fabrikmethode, die Dateipfade für sowohl URL als auch Logo akzeptiert. Der Leitfaden zur Anpassung des QR-Code-Stils umfasst Optionen für Logogröße, Positionierung und Farbkombinationen.

QRCoder-Ansatz:

using QRCoder;
using System.Drawing;
using System.Drawing.Imaging;

var generator = new QRCodeGenerator();
// ECCLevel.H is required — the logo occludes part of the code
var qrCodeData = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.H);

var qrCode = new QRCode(qrCodeData);
var logoBitmap = new Bitmap("logo.png");
var qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap);
qrBitmap.Save("qr-logo.png", ImageFormat.Png);

using QRCoder;
using System.Drawing;
using System.Drawing.Imaging;

var generator = new QRCodeGenerator();
// ECCLevel.H is required — the logo occludes part of the code
var qrCodeData = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.H);

var qrCode = new QRCode(qrCodeData);
var logoBitmap = new Bitmap("logo.png");
var qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap);
qrBitmap.Save("qr-logo.png", ImageFormat.Png);

Imports QRCoder
Imports System.Drawing
Imports System.Drawing.Imaging

Dim generator As New QRCodeGenerator()
' ECCLevel.H is required — the logo occludes part of the code
Dim qrCodeData = generator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.H)

Dim qrCode As New QRCode(qrCodeData)
Dim logoBitmap As New Bitmap("logo.png")
Dim qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap)
qrBitmap.Save("qr-logo.png", ImageFormat.Png)

IronBarcode -Ansatz:

using IronBarCode;

QRCodeWriter.CreateQrCodeWithLogo("https://example.com", "logo.png", 500)
    .SaveAsPng("qr-logo.png");

using IronBarCode;

QRCodeWriter.CreateQrCodeWithLogo("https://example.com", "logo.png", 500)
    .SaveAsPng("qr-logo.png");

Imports IronBarCode

QRCodeWriter.CreateQrCodeWithLogo("https://example.com", "logo.png", 500) _
    .SaveAsPng("qr-logo.png")

Die System.Drawing.Bitmap-Abhängigkeit wird entfernt — CreateQrCodeWithLogo akzeptiert Dateipfad-Strings für sowohl den Inhalt als auch das Logobild. Fehlerkorrektur wird automatisch auf das für die Logo-Einbettung erforderliche Niveau eingestellt; keine explizite ECC-Konfiguration erforderlich.

PayloadGenerator.WiFi-Migration

QRCoder's PayloadGenerator.WiFi formatiert den Standard-WiFi-QR-Payload-String. Das Ausgabeformat ist ein öffentlicher Standard (WIFI:T:{auth};S:{ssid};P:{password};;), der durch die QR-Code-Spezifikation definiert ist. Bei der Migration können diese Zeichenketten direkt erstellt werden.

QRCoder-Ansatz:

using QRCoder;

var wifi = new PayloadGenerator.WiFi(
    ssid: "OfficeNetwork",
    password: "SecurePass123",
    authenticationMode: PayloadGenerator.WiFi.Authentication.WPA
);
// wifi.ToString() produces: WIFI:T:WPA;S:OfficeNetwork;P:SecurePass123;;

var generator = new QRCodeGenerator();
var qrData = generator.CreateQrCode(wifi.ToString(), QRCodeGenerator.ECCLevel.M);
var qrCode = new PngByteQRCode(qrData);
System.IO.File.WriteAllBytes("wifi.png", qrCode.GetGraphic(10));

using QRCoder;

var wifi = new PayloadGenerator.WiFi(
    ssid: "OfficeNetwork",
    password: "SecurePass123",
    authenticationMode: PayloadGenerator.WiFi.Authentication.WPA
);
// wifi.ToString() produces: WIFI:T:WPA;S:OfficeNetwork;P:SecurePass123;;

var generator = new QRCodeGenerator();
var qrData = generator.CreateQrCode(wifi.ToString(), QRCodeGenerator.ECCLevel.M);
var qrCode = new PngByteQRCode(qrData);
System.IO.File.WriteAllBytes("wifi.png", qrCode.GetGraphic(10));

Imports QRCoder

Dim wifi = New PayloadGenerator.WiFi(
    ssid:="OfficeNetwork",
    password:="SecurePass123",
    authenticationMode:=PayloadGenerator.WiFi.Authentication.WPA
)
' wifi.ToString() produces: WIFI:T:WPA;S:OfficeNetwork;P:SecurePass123;;

Dim generator = New QRCodeGenerator()
Dim qrData = generator.CreateQrCode(wifi.ToString(), QRCodeGenerator.ECCLevel.M)
Dim qrCode = New PngByteQRCode(qrData)
System.IO.File.WriteAllBytes("wifi.png", qrCode.GetGraphic(10))

IronBarcode -Ansatz:

using IronBarCode;

// Construct the standard WiFi QR string directly
string wifiPayload = "WIFI:T:WPA;S:OfficeNetwork;P:SecurePass123;;";
BarcodeWriter.CreateBarcode(wifiPayload, BarcodeEncoding.QRCode)
    .ResizeTo(300, 300)
    .SaveAsPng("wifi.png");

using IronBarCode;

// Construct the standard WiFi QR string directly
string wifiPayload = "WIFI:T:WPA;S:OfficeNetwork;P:SecurePass123;;";
BarcodeWriter.CreateBarcode(wifiPayload, BarcodeEncoding.QRCode)
    .ResizeTo(300, 300)
    .SaveAsPng("wifi.png");

Imports IronBarCode

' Construct the standard WiFi QR string directly
Dim wifiPayload As String = "WIFI:T:WPA;S:OfficeNetwork;P:SecurePass123;;"
BarcodeWriter.CreateBarcode(wifiPayload, BarcodeEncoding.QRCode) _
    .ResizeTo(300, 300) _
    .SaveAsPng("wifi.png")

Für Teams mit vielen PayloadGenerator-Typen im Einsatz (vCard, CalendarEvent, Geo, SMS), ist der Ansatz der gleiche: Identifizieren Sie die formatierte Zeichenkette, die jeder Generator mit seiner .ToString()-Ausgabe produziert, und konstruieren Sie diese Zeichenkette direkt oder durch eine kleine statische Hilfsmethode.

Problem 1: Änderung des PayloadGenerator-Zeichenfolgenformats

QRCoder: PayloadGenerator.WiFi, PayloadGenerator.ContactData und andere Helfer erzeugen automatisch formatierte Zeichenketten. Der Code übergibt die .ToString()-Ausgabe des Helferobjekts an CreateQrCode.

Lösung: Identifizieren Sie die Zeichenkette, die jeder PayloadGenerator-Typ produziert — ihr Format ist in der QR-Code-Spezifikation dokumentiert und einfach zu reproduzieren. Für WiFi: WIFI:T:WPA;S:{ssid};P:{password};;. Für vCard: Standard BEGIN:VCARD / END:VCARD-Blöcke. Schreiben Sie statische Hilfsmethoden, wenn viele Aufrufstellen denselben Payload-Typ verwenden:

public static string WifiPayload(string ssid, string password, string auth = "WPA")
    => $"WIFI:T:{auth};S:{ssid};P:{password};;";

public static string WifiPayload(string ssid, string password, string auth = "WPA")
    => $"WIFI:T:{auth};S:{ssid};P:{password};;";

Public Shared Function WifiPayload(ssid As String, password As String, Optional auth As String = "WPA") As String
    Return $"WIFI:T:{auth};S:{ssid};P:{password};;"
End Function

Problem 2: ECCLevel-Enum-Zuordnung

QRCoder: QRCodeGenerator.ECCLevel ist ein verschachteltes Enum mit Werten L, M, Q, H. Es ist ein erforderlicher Parameter bei jedem CreateQrCode-Aufruf.

Lösung: Ordnen Sie jeden Wert seinem QRCodeWriter.QrErrorCorrectionLevel-Äquivalent zu, wenn Sie den QRCodeWriter-Weg verwenden. Wenn BarcodeWriter.CreateBarcode verwendet wird, wird das ECC-Level automatisch auf Medium gesetzt und erfordert keinen Parameter. Aktualisieren Sie jeden Anrufstandort:

// QR-Code ECCLevel.H → IronBarcode QrErrorCorrectionLevel.Highest
var qr = QRCodeWriter.CreateQrCode(data, 500, QRCodeWriter.QrErrorCorrectionLevel.Highest);

// QR-Code ECCLevel.M → IronBarcode default (no parameter needed)
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode);

// QR-Code ECCLevel.H → IronBarcode QrErrorCorrectionLevel.Highest
var qr = QRCodeWriter.CreateQrCode(data, 500, QRCodeWriter.QrErrorCorrectionLevel.Highest);

// QR-Code ECCLevel.M → IronBarcode default (no parameter needed)
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode);

' QR-Code ECCLevel.H → IronBarcode QrErrorCorrectionLevel.Highest
Dim qr = QRCodeWriter.CreateQrCode(data, 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)

' QR-Code ECCLevel.M → IronBarcode default (no parameter needed)
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode)

Problem 3: Entfernung der Renderer-Klasse

QRCoder: Jedes Ausgabeformat erfordert eine eigene Instanzierung der Rendererklasse — PngByteQRCode, SvgQRCode, AsciiQRCode, Base64QRCode, QRCode. Diese Klassen akzeptieren QRCodeData und legen GetGraphic mit unterschiedlichen Rückgabetypen offen.

Lösung: Entfernen Sie alle Instanziierungen der Renderer-Klasse. IronBarcode integriert die Formatausgabe in die Terminalmethoden der Fluent-Kette. Ersetzen Sie new PngByteQRCode(data).GetGraphic(n) durch .ToPngBinaryData() nach .ResizeTo(). Ersetzen Sie new SvgQRCode(data).GetGraphic(n) durch .SaveAsImage(path) (mit einer .svg-Erweiterung). Das QRCodeData-Zwischenobjekt verschwindet ebenfalls — es wird in IronBarcode nicht benötigt.

Ausgabe 4: Entfernung von PngByteQRCode und modulbasierte Größenanpassung

QRCoder: PngByteQRCode.GetGraphic(int pixelsPerModule) bestimmt die Ausgabe durch die Anzahl der Pixel pro QR-Modul. Die resultierenden Bildabmessungen hängen von der Anzahl der Module ab, die mit der Inhaltslänge und dem ECC-Level variiert.

Lösung: Ersetzen Sie die modulbasierte Größenanpassung durch ResizeTo(int width, int height) für absolute Pixelmaße. Wenn Ihr Code die erwartete Ausgabegröße dynamisch anhand der Modulanzahl berechnet hat, wechseln Sie zu einer festen Zielgröße, die Ihren Ausgabeanforderungen entspricht:

// Before: GetGraphic(20) — output size varies with content
var bytes = new PngByteQRCode(qrData).GetGraphic(20);

// After: fixed 400×400 regardless of content
byte[] bytes = BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode)
    .ResizeTo(400, 400)
    .ToPngBinaryData();

// Before: GetGraphic(20) — output size varies with content
var bytes = new PngByteQRCode(qrData).GetGraphic(20);

// After: fixed 400×400 regardless of content
byte[] bytes = BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode)
    .ResizeTo(400, 400)
    .ToPngBinaryData();

Imports System

' Before: GetGraphic(20) — output size varies with content
Dim bytes = New PngByteQRCode(qrData).GetGraphic(20)

' After: fixed 400×400 regardless of content
Dim bytes As Byte() = BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode) _
    .ResizeTo(400, 400) _
    .ToPngBinaryData()

Vor der Migration anfallende Aufgaben

Prüfen Sie den Quellcode auf alle QRCoder-Verwendungen, bevor Sie Änderungen vornehmen:

# Find all QR-Code namespace imports
grep -r "using QRCoder" --include="*.cs" .

# Find all generator and renderer instantiations
grep -r "QRCodeGenerator\|PngByteQRCode\|SvgQRCode\|AsciiQRCode\|QRCode\b" --include="*.cs" .

# Find all PayloadGenerator usages
grep -r "PayloadGenerator\." --include="*.cs" .

# Find ECCLevel references
grep -r "ECCLevel\." --include="*.cs" .

# Find ZXing.Net usage to remove at the same time
grep -r "using ZXing" --include="*.cs" .

# Find all QR-Code namespace imports
grep -r "using QRCoder" --include="*.cs" .

# Find all generator and renderer instantiations
grep -r "QRCodeGenerator\|PngByteQRCode\|SvgQRCode\|AsciiQRCode\|QRCode\b" --include="*.cs" .

# Find all PayloadGenerator usages
grep -r "PayloadGenerator\." --include="*.cs" .

# Find ECCLevel references
grep -r "ECCLevel\." --include="*.cs" .

# Find ZXing.Net usage to remove at the same time
grep -r "using ZXing" --include="*.cs" .

• Dokumentieren Sie alle PayloadGenerator-Typen im Einsatz und notieren Sie deren Zeichenkette-Ausgabeformate
• Notieren Sie alle verwendeten ECC-Level-Werte und deren Aufrufstellen.
• Identifizieren Sie jeglichen ZXing .NET -Lesecode, der zum Dekodieren mit QR-Code gekoppelt war – dieser kann gleichzeitig ersetzt werden
• Besorgen Sie sich einen IronBarcode -Lizenzschlüssel (Testschlüssel sind ohne Registrierung erhältlich)

Aufgaben der Code-Aktualisierung

1. Führen Sie dotnet remove package QRCoder aus
2. Führen Sie dotnet remove package ZXing.Net aus, wenn es nur zum Lesen zusammen mit QR-Code verwendet wurde
3. Führen Sie dotnet add package IronBarcode aus
4. Fügen Sie IronBarCode.License.LicenseKey = "YOUR-KEY"; zum Anwendungsstart hinzu
5. Ersetzen Sie alle using QRCoder;-Importe durch using IronBarCode;
6. Entfernen Sie alle new QRCodeGenerator()-Instanzerklärungen — BarcodeWriter ist statisch
7. Ersetzen Sie alle generator.CreateQrCode(data, ECCLevel.X) + Renderer-Chaining-Muster durch BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode)-Chaining
8. Ersetzen Sie .GetGraphic(n)-Aufrufe durch .ToPngBinaryData() und fügen Sie .ResizeTo(w, h) vor dem Terminal hinzu
9. Ersetzen Sie File.WriteAllBytes(path, bytes)-Speichermuster durch .SaveAsPng(path)-Terminalmethoden
10. Ersetzen Sie new SvgQRCode(data).GetGraphic(n) durch .SaveAsImage(path) (mit einer .svg-Erweiterung)
11. Ersetzen Sie PayloadGenerator.WiFi(...) und andere Helferinstanzen durch direkte Formatzeichenketten
12. Ordnen Sie jeden QRCodeGenerator.ECCLevel-Wert seinem QRCodeWriter.QrErrorCorrectionLevel-Äquivalent zu
13. Ersetzen Sie alle ZXing.Net BarcodeReaderGeneric.Decode(bitmap)-Aufrufe durch BarcodeReader.Read(path)
14. Für die Logoeinbettung ersetzen Sie new QRCode(data).GetGraphic(n, ..., logoBitmap) durch QRCodeWriter.CreateQrCodeWithLogo(data, logoPath, size)

Post-Migrationstests

• Scannen Sie alle generierten QR-Codes mit mindestens zwei unabhängigen QR-Code-Scanner-Anwendungen, um die Lesbarkeit zu überprüfen.
• Verifizieren Sie, dass Logos eingebaute QR-Codes korrekt gescannt werden — bestätigen Sie, dass das Fehlerkorrektur-Level Highest ist
• Vergleichen Sie die visuelle Ausgabe der generierten Codes mit Beispielen aus der Zeit vor der Migration, bei denen eine einheitliche Darstellung erforderlich ist.
• Testen Sie alle PayloadGenerator-Ersetzungen — bestätigen Sie, dass WiFi-, vCard- und andere Payload-Zeichenketten auf Zielgeräten korrekt dekodiert werden
• Falls ZXing.Net ebenfalls entfernt wurde, verifizieren Sie, dass alle Strichcode-Lesewege durch BarcodeReader.Read funktionieren
• Führen Sie die Anwendung in einer sauberen Umgebung aus, um sicherzustellen, dass keine verbleibenden QRCoder- oder ZXing .NET -Referenzen Bindungsfehler verursachen.
• Überprüfen Sie, ob der IronBarcode -Lizenzschlüssel in Produktions- und Testumgebungen korrekt geladen wurde.