O problema fundamental

MessagingToolkit.Barcode impõe uma dependência de System.Drawing e um fluxo de trabalho baseado em instância que é incompatível com o .NET moderno:

// 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 remove completamente a dependência de System.Drawing e funciona identicamente no Windows, Linux, macOS e em contêineres Docker:

// 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");  // Não Bitmap, 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");  // Não Bitmap, 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") ' Não Bitmap, no System.Drawing
For Each result In results
    Console.WriteLine(result.Value)
Next

Passo 1: Substitua o pacote NuGet

Remova o pacote MessagingToolkit.Barcode:

dotnet remove package MessagingToolkit.Barcode

dotnet remove package MessagingToolkit.Barcode

Se o projeto fizer referência a MessagingToolkit.Barcode.dll diretamente através de uma entrada <HintPath> no arquivo .csproj, remova essa referência também.

Instale o IronBarcode:

dotnet add package IronBarcode

dotnet add package IronBarcode

O IronBarcode é compatível com o .NET Framework 4.6.2 até o .NET 9. Ele é instalado como um pacote único com todas as dependências incluídas — nenhuma biblioteca gráfica separada ou referência ZXing é necessária.

Etapa 2: Atualizar Namespaces

Substitua o namespace MessagingToolkit pelo namespace IronBarcode em cada arquivo que referencia a biblioteca antiga:

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

Arquivos que importaram System.Drawing apenas para o tipo Bitmap usado com MessagingToolkit.Barcode podem ter essa importação removida uma vez que o IronBarcode esteja em vigor.

Etapa 3: Inicializar a licença

Adicione a inicialização da licença uma vez no início da aplicação — em Program.cs, Startup.cs ou no ponto de entrada equivalente. É necessária uma chave de licença para uso em produção; A biblioteca opera em modo de avaliação sem um.

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

Leitura de códigos de barras a partir de arquivos de imagem

A abordagem antiga exigia a construção de um Bitmap a partir do caminho do arquivo e passá-lo para uma instância BarcodeDecoder. O IronBarcode aceita o caminho do arquivo diretamente.

MessagingToolkit.Abordagem de código de barras:

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

Abordagem do IronBarcode:

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

A versão do IronBarcode remove a construção Bitmap e o padrão condicional nulo em um único objeto. BarcodeReader.Read() retorna uma coleção — uma coleção vazia quando nada é encontrado — então .FirstOrDefault() substitui a verificação de nulo no antigo valor de retorno de resultado único.

Acessando informações de formato a partir dos resultados

MessagingToolkit.Barcode expôs o formato detectado através de result.BarcodeFormat.IronBarcode expõe isso através de result.Format. Ambos são valores de enumeração no objeto de resultado, com nomes de tipo de enumeração diferentes.

MessagingToolkit.Abordagem de código de barras:

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

Abordagem do IronBarcode:

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

O nome da propriedade muda de .Text para .Value e de .BarcodeFormat para .Format. O tipo enum muda de BarcodeFormat (MessagingToolkit) para BarcodeEncoding (IronBarcode), embora .Format.ToString() produza uma string comparável, legível por humanos, para exibição ou fins de registro.

Gerando Códigos de Barra

MessagingToolkit.Barcode usava um BarcodeEncoder baseado em instância com um formato de conjunto de propriedades antes de chamar .Encode().IronBarcode utiliza um método estático com o tipo de codificação como parâmetro.

MessagingToolkit.Abordagem de código de barras:

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

Abordagem do IronBarcode:

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

Para criar códigos de barras Code 128 e outros códigos de barras 1D , o mesmo padrão estático se aplica, porém com uma constante de codificação diferente:

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

Atualizando a estrutura de destino

Após a remoção do MessagingToolkit.Barcode e a substituição de todas as referências, o framework de destino do arquivo de projeto poderá ser atualizado. Essa alteração estava bloqueada pela dependência antiga e só será possível após a sua remoção:

MessagingToolkit.Barcode Approach (arquivo de projeto):

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

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

Abordagem IronBarcode(arquivo do projeto):

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

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

O IronBarcode é compatível com o .NET Framework 4.6.2 até o .NET 9, portanto, pode ser instalado antes da conclusão da atualização do framework. Isso permite que a migração seja feita em etapas: instale o IronBarcode juntamente com o MessagingToolkit.Barcode, substitua todas as ocorrências, verifique o novo código, remova o pacote antigo e, por fim, altere a estrutura de destino.

Leitura de códigos de barras em documentos PDF

O MessagingToolkit.Barcode não tinha suporte para PDF. A leitura de códigos de barras em um PDF exigia a extração de imagens de cada página por meio de uma biblioteca separada antes de chamar o decodificador de código de barras. O IronBarcode lê arquivos PDF diretamente, utilizando o mesmo método usado para imagens.

MessagingToolkit.Abordagem de código de barras:

// Not supported — required external PDF page extraction before decode
// Não equivalent exists in MessagingToolkit.Barcode

// Not supported — required external PDF page extraction before decode
// Não equivalent exists in MessagingToolkit.Barcode

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

Abordagem do IronBarcode:

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

Aplicações que processam documentos digitalizados, manifestos de remessa ou lotes de faturas com várias páginas ganham essa capacidade como parte da migração, sem necessidade de biblioteca ou configuração adicional.

Problema 1: Namespace não encontrado após atualização do pacote

Problema: Após remover MessagingToolkit.Barcode e adicionar IronBarcode, a compilação falha com CS0246: The type or namespace name 'BarcodeDecoder' could not be found.

Solução: O antigo namespace using MessagingToolkit.Barcode; deve ser substituído por using IronBarCode; (note o C maiúsculo) em todos os arquivos que referenciam a biblioteca antiga. Uma busca em todo o projeto pela string de namespace antiga localizará todos os arquivos afetados:

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

Problema 2: Ambiguidade do Leitor de Código de Barras entre Namespaces

Problema: Se um projeto referenciar tanto MessagingToolkit.Barcode quanto IronBarcode durante uma migração escalonada, BarcodeReader pode ser ambíguo entre os dois namespaces.

Solução: Qualificar explicitamente a referência durante o período de transição:

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

Uma vez que todas as referências a MessagingToolkit.Barcode tenham sido substituídas e o pacote antigo removido, o qualificador pode ser eliminado e a diretiva using IronBarCode; é suficiente.

Problema 3: Framework de destino ainda definido como net472 após a remoção do pacote

Problema: Após remover MessagingToolkit.Barcode e instalar IronBarcode, o arquivo do projeto ainda tem como alvo net472. Os avisos de compilação indicam que as APIs modernas do .NET não estão disponíveis.

Solução: Atualize o elemento <TargetFramework> no arquivo .csproj uma vez que a dependência tenha sido removida.IronBarcode suporta tanto net472 (via compatibilidade com .NET Framework 4.6.2) quanto alvos modernos. A alteração para net8.0 requer verificar que nenhuma outra dependência legada permaneça no projeto:

<TargetFramework>net8.0</TargetFramework>

<TargetFramework>net8.0</TargetFramework>

Execute dotnet build após a alteração para identificar qualquer dependência legada remanescente que precise ser abordada.

Tarefas pré-migração

Audite a base de código para identificar todos os locais que fazem referência a MessagingToolkit.Barcode:

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

Documente todos os arquivos que precisam de alterações. Observe quaisquer locais onde System.Drawing.Bitmap é usado como entrada para o decodificador — esses usos também precisarão ser atualizados.

Tarefas de atualização de código

1. Execute dotnet remove package MessagingToolkit.Barcode para remover o pacote
2. Execute dotnet add package IronBarcode para instalar o IronBarcode
3. Adicione IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"; no início da aplicação
4. Substitua todas as instruções using MessagingToolkit.Barcode; por using IronBarCode;
5. Substitua todos os padrões new BarcodeDecoder() por chamadas estáticas BarcodeReader.Read()
6. Substitua todos os padrões new BarcodeEncoder() por chamadas estáticas BarcodeWriter.CreateBarcode()
7. Atualize todas as referências result.Text para result.Value
8. Atualize todas as referências result.BarcodeFormat para result.Format
9. Atualize todos os padrões barcodeWriter.Format = BarcodeFormat.X para passar a codificação como parâmetro
10. Substitua bitmap.Save() por .SaveAsPng() ou o método de saída apropriado no resultado do IronBarcode
11. Remova importações using System.Drawing; onde foram usadas apenas para entrada Bitmap no MessagingToolkit
12. Atualize <TargetFramework> no arquivo do projeto se uma atualização de framework fizer parte da migração

Testes pós-migração

• Verifique se dotnet build completa com zero erros e zero referências a MessagingToolkit
• Execute grep -r "MessagingToolkit" --include="*.cs" . e confirme zero resultados
• Teste a leitura de código de barras com imagens de códigos de barras reais do seu aplicativo e confirme que .Value retorna a string esperada
• Teste a leitura de código de barras com imagens de múltiplos códigos de barras e confirme se todos os códigos de barras da coleção foram retornados.
• Testar a geração de código de barras e verificar se o arquivo de saída corresponde ao formato e à codificação esperados.
• Se a leitura de PDF for utilizada, faça um teste com um documento PDF representativo e verifique se os metadados do número da página estão corretos.
• Se a estrutura de destino foi alterada, execute o Suite completo de testes no novo ambiente de execução para identificar quaisquer outros problemas de compatibilidade.