O problema fundamental

OQRCoderresolve a geração de QR Codes de forma eficiente. Não momento em que qualquer requisito ultrapassa o QR, a base de código deve começar a incorporar pacotes adicionais para preencher cada lacuna:

//QRCoderhandles 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

//QRCoderhandles 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 consolida geração, leitura e integração de PDF em uma única 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")

Passo 1: Substitua o pacote NuGet

Remova oQRCoderdo projeto:

dotnet remove package QRCoder

dotnet remove package QRCoder

Instale o IronBarcode:

dotnet add package IronBarcode

dotnet add package IronBarcode

Se o projeto estiver usando o ZXing .NET juntamente com oQRCoderpara leitura de código de barras, esse pacote também pode ser removido nesta etapa:

dotnet remove package ZXing.Net

dotnet remove package ZXing.Net

Etapa 2: Atualizar Namespaces

Substitua a importação do namespaceQRCoderpelo namespace IronBarcode:

// Before (QRCoder)
using QRCoder;

// After (IronBarcode)
using IronBarCode;

// Before (QRCoder)
using QRCoder;

// After (IronBarcode)
using IronBarCode;

' Before (QRCoder)
Imports QRCoder

' After (IronBarcode)
Imports IronBarCode

Etapa 3: Inicializar a licença

Adicione a inicialização da licença na inicialização do aplicativo — Program.cs, Startup.cs ou um construtor estático:

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

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

Imports IronBarCode

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

Uma chave de avaliação gratuita está disponível sem necessidade de cadastro. Implantações em produção exigem uma licença adquirida.

Geração básica de código QR

O padrão mais comum doQRCoderrequer três objetos: uma instância de QRCodeGenerator, um objeto intermediário QRCodeData e uma classe renderizadora como PngByteQRCode. Em IronBarcode, uma única chamada estática substitui essa cadeia.

Abordagem do QRCoder:

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

Abordagem do IronBarcode:

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 é uma classe estática — nenhuma instância é necessária e não há objeto de dados intermediário. O método ResizeTo(width, height) substitui o inteiro pixel-por-módulo que oQRCoderaceita em GetGraphic. Onde oQRCoderdimensiona a saída por contagem de módulos (por exemplo, GetGraphic(10) para uma imagem de 10px por módulo), o IronBarcode toma dimensões absolutas de pixel.

Salvar códigos QR em um arquivo

OQRCodersepara os bytes na memória da saída do arquivo apenas na etapa do terminal — a cadeia de renderização é a mesma.IronBarcode utiliza diferentes métodos de terminal na mesma cadeia.

Abordagem do QRCoder:

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)

Abordagem do IronBarcode:

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()

O método SaveAsPng é um terminal que grava diretamente no disco. ToPngBinaryData retorna um byte[] para streaming, respostas HTTP ou armazenamento no banco de dados.

Saída SVG

Abordagem do QRCoder:

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)

Abordagem do IronBarcode:

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")

A classe renderizadora SvgQRCode e sua chamada GetGraphic colapsam em um único método terminal SaveAsImage (passar uma extensão .svg produz uma saída SVG).

Mapeamento do nível de correção de erros

OQRCoderrequer seleção explícita de ECC em cada chamada CreateQrCode usando o enum QRCodeGenerator.ECCLevel. O IronBarcode aplica um padrão sensato ao usar BarcodeWriter.CreateBarcode e expõe controle explícito através de QRCodeWriter.QrErrorCorrectionLevel.

Abordagem do QRCoder:

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)

Abordagem do IronBarcode:

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")

O mapeamento de nível é: ECCLevel.L → Low, ECCLevel.M → Medium, ECCLevel.Q → High, ECCLevel.H → Highest.

Incorporação de logotipo

Ambas as bibliotecas suportam a incorporação de logotipos em códigos QR. OQRCoderroteia isso através da classe renderizadora QRCode (não PngByteQRCode) com parâmetros System.Drawing.Bitmap. O IronBarcode fornece QRCodeWriter.CreateQrCodeWithLogo() como um método de fábrica dedicado que aceita caminhos de arquivos tanto para o URL quanto para o logotipo. O guia de personalização do código QR abrange opções de tamanho, posicionamento e combinação de cores do logotipo.

Abordagem do QRCoder:

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)

Abordagem do IronBarcode:

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")

A dependência System.Drawing.Bitmap é removida — CreateQrCodeWithLogo aceita strings de caminho de arquivo tanto para o conteúdo quanto para a imagem do logotipo. A correção de erros é configurada automaticamente para o nível exigido para incorporação de logotipos; nenhuma configuração de ECC explícita é necessária.

Gerador de carga útil. Migração para WiFi

O PayloadGenerator.WiFi doQRCoderformata a string padrão da carga útil do QR WiFi. O formato de saída é um padrão público (WIFI:T:{auth};S:{ssid};P:{password};;) definido pela especificação do código QR. Durante a migração, essas strings podem ser construídas diretamente.

Abordagem do QRCoder:

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))

Abordagem do IronBarcode:

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")

Para equipes com muitos tipos de PayloadGenerator em uso (vCard, CalendarEvent, Geo, SMS), a abordagem é a mesma: identificar a string formatada que cada gerador produz usando sua saída .ToString(), depois construir essa string diretamente ou através de um pequeno método auxiliar estático.

Problema 1: Alteração no formato da string do PayloadGenerator

QRCoder: PayloadGenerator.WiFi, PayloadGenerator.ContactData e outros auxiliares produzem strings formatadas automaticamente. O código passa a saída do objeto auxiliar .ToString() para CreateQrCode.

Solução: Identifique a string que cada tipo PayloadGenerator produz — seu formato está documentado na especificação do código QR e é fácil de reproduzir. Para WiFi: WIFI:T:WPA;S:{ssid};P:{password};;. Para vCard: blocos padrão BEGIN:VCARD / END:VCARD. Escreva métodos auxiliares estáticos caso vários locais de chamada utilizem o mesmo tipo de carga útil:

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

Problema 2: Mapeamento de Enum ECCLevel

QRCoder: QRCodeGenerator.ECCLevel é um enum aninhado com os valores L, M, Q, H. É um parâmetro necessário em cada chamada CreateQrCode.

Solução: Mapeie cada valor para seu equivalente QRCodeWriter.QrErrorCorrectionLevel ao usar o caminho QRCodeWriter. Ao usar BarcodeWriter.CreateBarcode, o nível ECC padrão para Médio automaticamente e não requer parâmetro. Atualize cada local de chamada:

//QRCoderECCLevel.H →IronBarcode QrErrorCorrectionLevel.Highest
var qr = QRCodeWriter.CreateQrCode(data, 500, QRCodeWriter.QrErrorCorrectionLevel.Highest);

//QRCoderECCLevel.M →IronBarcode default (no parameter needed)
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode);

//QRCoderECCLevel.H →IronBarcode QrErrorCorrectionLevel.Highest
var qr = QRCodeWriter.CreateQrCode(data, 500, QRCodeWriter.QrErrorCorrectionLevel.Highest);

//QRCoderECCLevel.M →IronBarcode default (no parameter needed)
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode);

'QRCoderECCLevel.H →IronBarcode QrErrorCorrectionLevel.Highest
Dim qr = QRCodeWriter.CreateQrCode(data, 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)

'QRCoderECCLevel.M →IronBarcode default (no parameter needed)
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode)

Problema 3: Remoção da classe de renderização

QRCoder: Cada formato de saída requer sua própria instanciação da classe renderizadora — PngByteQRCode, SvgQRCode, AsciiQRCode, Base64QRCode, QRCode. Essas classes aceitam QRCodeData e expõem GetGraphic com diferentes tipos de retorno.

Solução: Remova todas as instâncias da classe de renderização. O IronBarcode incorpora a saída formatada nos métodos terminais da cadeia fluente. Substitua new PngByteQRCode(data).GetGraphic(n) por .ToPngBinaryData() após .ResizeTo(). Substitua new SvgQRCode(data).GetGraphic(n) por .SaveAsImage(path) (passando uma extensão .svg). O objeto intermediário QRCodeData também desaparece — não é necessário no IronBarcode.

Problema 4: Remoção de PngByteQRCode e dimensionamento baseado em módulos

QRCoder: PngByteQRCode.GetGraphic(int pixelsPerModule) dimensiona a saída pelo número de pixels por módulo QR. As dimensões da imagem resultante dependem do número de módulos, que varia de acordo com o comprimento do conteúdo e o nível de ECC.

Solução: Substitua o dimensionamento baseado em módulos por ResizeTo(int width, int height) para dimensões absolutas de pixel. Se o seu código calcula o tamanho de saída esperado dinamicamente a partir da contagem de módulos, mude para um tamanho de destino fixo que atenda aos seus requisitos de saída:

// 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()

Tarefas pré-migração

Antes de fazer qualquer alteração, audite o código-fonte de todos os usuários do QRCoder:

# Find allQRCodernamespace 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 allQRCodernamespace 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" .

• Documente todos os tipos de PayloadGenerator em uso e anote seus formatos de saída de string
• Observe todos os valores de nível ECC em uso e seus respectivos pontos de chamada.
• Identifique qualquer código de leitura ZXing .NET que tenha sido emparelhado com oQRCoderpara decodificação — este pode ser substituído ao mesmo tempo.
• Obtenha uma chave de licença do IronBarcode(chaves de avaliação estão disponíveis sem necessidade de cadastro)

Tarefas de atualização de código

1. Execute dotnet remove package QRCoder
2. Execute dotnet remove package ZXing.Net se ele foi usado apenas para leitura junto com o QRCoder
3. Execute dotnet add package IronBarcode
4. Adicione IronBarCode.License.LicenseKey = "YOUR-KEY"; à inicialização do aplicativo
5. Substitua todas as importações using QRCoder; por using IronBarCode;
6. Remova todas as declarações de instância new QRCodeGenerator() — BarcodeWriter é estático
7. Substitua todos os padrões de corrente do renderizador + generator.CreateQrCode(data, ECCLevel.X) por correntes BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode)
8. Substitua as chamadas .GetGraphic(n) por .ToPngBinaryData() e adicione .ResizeTo(w, h) antes do terminal
9. Substitua os padrões de salvar File.WriteAllBytes(path, bytes) por métodos terminais .SaveAsPng(path)
10. Substitua new SvgQRCode(data).GetGraphic(n) por .SaveAsImage(path) (passe uma extensão .svg)
11. Substitua as instanciações do helper PayloadGenerator.WiFi(...) e outros auxiliares por strings de formato direto
12. Mapeie cada valor QRCodeGenerator.ECCLevel para seu equivalente QRCodeWriter.QrErrorCorrectionLevel
13. Substitua qualquer chamada BarcodeReaderGeneric.Decode(bitmap) do ZXing.Net por BarcodeReader.Read(path)
14. Para a incorporação de logotipo, substitua new QRCode(data).GetGraphic(n, ..., logoBitmap) por QRCodeWriter.CreateQrCodeWithLogo(data, logoPath, size)

Testes pós-migração

• Escaneie todos os códigos QR gerados com pelo menos dois aplicativos de leitura de código QR independentes para verificar a legibilidade.
• Verifique se os códigos QR incorporados no logotipo são escaneados corretamente — confirme se o nível de correção de erro é Highest
• Comparar a saída visual dos códigos gerados com amostras pré-migração onde a consistência visual é necessária.
• Teste todas as substituições PayloadGenerator — confirme se WiFi, vCard e outras strings de carga útil são decodificadas corretamente nos dispositivos alvo
• Se o ZXing.Net também foi removido, verifique se todos os caminhos de leitura de código de barras funcionam através de BarcodeReader.Read
• Execute o aplicativo em um ambiente limpo para confirmar que nenhuma referência residual aoQRCoderou ao ZXing .NET esteja causando falhas de vinculação.
• Verifique se a chave de licença do IronBarcode está carregada corretamente nos ambientes de produção e de teste.