O problema fundamental

O loop de suposição de tipo é o sintoma mais visível da restrição obrigatória BarCodeType. Em um código-fonte Spire.Barcode que processa documentos de múltiplas fontes, esse padrão aparece repetidamente:

// Spire.Barcode: growing candidate loop with silent misses
BarcodeScanner scanner = new BarcodeScanner();
var candidates = new[] { BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417 };

string foundValue = null;
foreach (var type in candidates)
{
    string[] found = scanner.Scan("barcode.png", type);
    if (found.Length > 0)
    {
        foundValue = found[0];
        break;
    }
}

// Spire.Barcode: growing candidate loop with silent misses
BarcodeScanner scanner = new BarcodeScanner();
var candidates = new[] { BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417 };

string foundValue = null;
foreach (var type in candidates)
{
    string[] found = scanner.Scan("barcode.png", type);
    if (found.Length > 0)
    {
        foundValue = found[0];
        break;
    }
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim candidates = {BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417}

Dim foundValue As String = Nothing
For Each type In candidates
    Dim found As String() = scanner.Scan("barcode.png", type)
    If found.Length > 0 Then
        foundValue = found(0)
        Exit For
    End If
Next

IronBarcode remove o loop completamente. A detecção de formato está integrada à biblioteca:

// IronBarcode: single call, all formats, type included in result
var results = BarcodeReader.Read("barcode.png");

foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

// IronBarcode: single call, all formats, type included in result
var results = BarcodeReader.Read("barcode.png");

foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

Imports IronBarcode

' IronBarcode: single call, all formats, type included in result
Dim results = BarcodeReader.Read("barcode.png")

For Each result In results
    Console.WriteLine($"{result.Format}: {result.Value}")
Next

Passo 1: Substitua o pacote NuGet

Remova o pacote ou pacotes Spire atualmente em uso:

# Remove whichever variant is installed
dotnet remove package FreeSpire.Barcode
# or
dotnet remove package Spire.Barcode

# If Spire.PDF was installed only for barcode extraction, remove it as well
dotnet remove package Spire.PDF

# Remove whichever variant is installed
dotnet remove package FreeSpire.Barcode
# or
dotnet remove package Spire.Barcode

# If Spire.PDF was installed only for barcode extraction, remove it as well
dotnet remove package Spire.PDF

Se Spire.PDF for usado para outras operações de documento além da extração de código de barras, retenha-o e remova apenas os caminhos de código relacionados ao código de barras.

Instale o IronBarcode:

dotnet add package IronBarcode

dotnet add package IronBarcode

Etapa 2: Atualizar Namespaces

Substitua todas as importações de namespace do Spire pelo namespace IronBarcode:

// Remove:
using Spire.Barcode;
using Spire.Pdf;

// Add:
using IronBarCode;

// Remove:
using Spire.Barcode;
using Spire.Pdf;

// Add:
using IronBarCode;

Imports IronBarCode

Etapa 3: Inicializar a licença

Substitua a inicialização da licença Spire por uma única atribuição de propriedade do IronBarcode na inicialização do aplicativo. Consulte a página de licenciamento do IronBarcode para obter informações sobre formatos de chave e opções de implantação:

// Remove (FreeSpire registration):
Spire.Barcode.BarcodeSettings.ApplyKey("your-free-key");

// Remove (commercial Spire license):
Spire.License.LicenseProvider.SetLicenseKey("your-commercial-key");

// Add (IronBarcode):
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Remove (FreeSpire registration):
Spire.Barcode.BarcodeSettings.ApplyKey("your-free-key");

// Remove (commercial Spire license):
Spire.License.LicenseProvider.SetLicenseKey("your-commercial-key");

// Add (IronBarcode):
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

' Remove (FreeSpire registration):
Spire.Barcode.BarcodeSettings.ApplyKey("your-free-key")

' Remove (commercial Spire license):
Spire.License.LicenseProvider.SetLicenseKey("your-commercial-key")

' Add (IronBarcode):
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Para ambientes Docker e de CI, a chave de licença pode ser fornecida por meio de uma variável de ambiente:

IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE");

IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE");

Imports System

IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE")

Leitura de um código de barras de formato conhecido

Uma leitura de formato único no Spire.Barcode passa o tipo explicitamente e recebe um string[].

Abordagem Spire.Barcode:

using Spire.Barcode;

BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("shipping-label.png", BarCodeType.Code128);

if (results.Length > 0)
{
    ProcessShipment(results[0]);
}

using Spire.Barcode;

BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("shipping-label.png", BarCodeType.Code128);

if (results.Length > 0)
{
    ProcessShipment(results[0]);
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim results As String() = scanner.Scan("shipping-label.png", BarCodeType.Code128)

If results.Length > 0 Then
    ProcessShipment(results(0))
End If

Abordagem do IronBarcode:

using IronBarCode;

var results = BarcodeReader.Read("shipping-label.png");

if (results.Any())
{
    ProcessShipment(results.First().Value);
}

using IronBarCode;

var results = BarcodeReader.Read("shipping-label.png");

if (results.Any())
{
    ProcessShipment(results.First().Value);
}

Imports IronBarCode

Dim results = BarcodeReader.Read("shipping-label.png")

If results.Any() Then
    ProcessShipment(results.First().Value)
End If

O parâmetro BarCodeType é removido. Se a lógica subsequente precisar confirmar o formato detectado, results.First().Format fornece isso sem requerer uma variável de estado separada.

Colapso de um Loop de Tipos de Formato Misto

Quando uma base de código Spire.Barcode lida com documentos que podem conter diversos formatos, o ciclo de tentativa e erro de tipo se acumula ao longo do tempo à medida que novos formatos entram no fluxo de trabalho.

Abordagem Spire.Barcode:

using Spire.Barcode;

BarcodeScanner scanner = new BarcodeScanner();
BarCodeType[] candidates = new[]
{
    BarCodeType.Code128,
    BarCodeType.QRCode,
    BarCodeType.DataMatrix,
    BarCodeType.EAN13,
    BarCodeType.PDF417
};

List<string> allValues = new List<string>();
foreach (BarCodeType type in candidates)
{
    string[] found = scanner.Scan("document-scan.png", type);
    allValues.AddRange(found);
}

using Spire.Barcode;

BarcodeScanner scanner = new BarcodeScanner();
BarCodeType[] candidates = new[]
{
    BarCodeType.Code128,
    BarCodeType.QRCode,
    BarCodeType.DataMatrix,
    BarCodeType.EAN13,
    BarCodeType.PDF417
};

List<string> allValues = new List<string>();
foreach (BarCodeType type in candidates)
{
    string[] found = scanner.Scan("document-scan.png", type);
    allValues.AddRange(found);
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim candidates As BarCodeType() = {
    BarCodeType.Code128,
    BarCodeType.QRCode,
    BarCodeType.DataMatrix,
    BarCodeType.EAN13,
    BarCodeType.PDF417
}

Dim allValues As New List(Of String)()
For Each type As BarCodeType In candidates
    Dim found As String() = scanner.Scan("document-scan.png", type)
    allValues.AddRange(found)
Next

Abordagem do IronBarcode:

using IronBarCode;

// The entire loop is replaced by a single call
var results = BarcodeReader.Read("document-scan.png");
List<string> allValues = results.Select(r => r.Value).ToList();

using IronBarCode;

// The entire loop is replaced by a single call
var results = BarcodeReader.Read("document-scan.png");
List<string> allValues = results.Select(r => r.Value).ToList();

Imports IronBarCode

' The entire loop is replaced by a single call
Dim results = BarcodeReader.Read("document-scan.png")
Dim allValues As List(Of String) = results.Select(Function(r) r.Value).ToList()

A função de leitura de imagens do IronBarcode processa todas as mais de 50 simbologias em uma única passagem. Quando a velocidade de leitura precisa ser ajustada para processamento em lote de alto volume, BarcodeReaderOptions fornece esse controle sem adicionar ramificações específicas de formato:

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var results = BarcodeReader.Read("document-scan.png", options);

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var results = BarcodeReader.Read("document-scan.png", options);

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim results = BarcodeReader.Read("document-scan.png", options)

Para orientação sobre como selecionar o valor ReadingSpeed apropriado, consulte a documentação das opções de velocidade de leitura.

Geração de um código de barras

A geração do Spire.Barcode requer a instanciação de um objeto BarcodeSettings, a atribuição de cada propriedade individualmente, a passagem das configurações para um BarCodeGenerator e, em seguida, a chamada de GenerateImage() antes de qualquer arquivo ser gravado.

Abordagem Spire.Barcode:

using Spire.Barcode;

BarcodeSettings settings = new BarcodeSettings();
settings.Type = BarCodeType.Code128;
settings.Data = "SHIP-9842-XZ";
settings.ShowText = true;
settings.TextMargin = 5;
settings.BarHeight = 60;
settings.Unit = GraphicsUnit.Pixel;

BarCodeGenerator generator = new BarCodeGenerator(settings);
Image barcodeImage = generator.GenerateImage();
barcodeImage.Save("shipping-label.png", ImageFormat.Png);

using Spire.Barcode;

BarcodeSettings settings = new BarcodeSettings();
settings.Type = BarCodeType.Code128;
settings.Data = "SHIP-9842-XZ";
settings.ShowText = true;
settings.TextMargin = 5;
settings.BarHeight = 60;
settings.Unit = GraphicsUnit.Pixel;

BarCodeGenerator generator = new BarCodeGenerator(settings);
Image barcodeImage = generator.GenerateImage();
barcodeImage.Save("shipping-label.png", ImageFormat.Png);

Imports Spire.Barcode
Imports System.Drawing
Imports System.Drawing.Imaging

Dim settings As New BarcodeSettings()
settings.Type = BarCodeType.Code128
settings.Data = "SHIP-9842-XZ"
settings.ShowText = True
settings.TextMargin = 5
settings.BarHeight = 60
settings.Unit = GraphicsUnit.Pixel

Dim generator As New BarCodeGenerator(settings)
Dim barcodeImage As Image = generator.GenerateImage()
barcodeImage.Save("shipping-label.png", ImageFormat.Png)

Abordagem do IronBarcode:

using IronBarCode;

BarcodeWriter.CreateBarcode("SHIP-9842-XZ", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("shipping-label.png");

using IronBarCode;

BarcodeWriter.CreateBarcode("SHIP-9842-XZ", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("shipping-label.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("SHIP-9842-XZ", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("shipping-label.png")

O objeto mutável BarcodeSettings e a instância separada BarCodeGenerator são substituídos por uma única chamada de fábrica estática com uma cadeia fluente. Não há risco de configurações serem compartilhadas acidentalmente em chamadas simultâneas porque cada invocação CreateBarcode() é independente.

Leitura de códigos de barras em um documento PDF

O Spire.Barcode não consegue ler PDFs diretamente. A abordagem baseada no Spire requer o pacote Spire.PDF separado para abrir o arquivo, iterar suas páginas, extrair imagens raster de cada página e, em seguida, passar essas imagens uma a uma para o leitor de códigos de barras.

Abordagem Spire.Barcode:

using Spire.Pdf;
using Spire.Barcode;

var pdf = new PdfDocument();
pdf.LoadFromFile("invoices.pdf");

var scanner = new BarcodeScanner();
var extractedValues = new List<string>();

foreach (PdfPageBase page in pdf.Pages)
{
    Image[] images = page.ExtractImages();
    foreach (Image image in images)
    {
        string[] found = scanner.Scan(image, BarCodeType.QRCode);
        extractedValues.AddRange(found);
    }
}

using Spire.Pdf;
using Spire.Barcode;

var pdf = new PdfDocument();
pdf.LoadFromFile("invoices.pdf");

var scanner = new BarcodeScanner();
var extractedValues = new List<string>();

foreach (PdfPageBase page in pdf.Pages)
{
    Image[] images = page.ExtractImages();
    foreach (Image image in images)
    {
        string[] found = scanner.Scan(image, BarCodeType.QRCode);
        extractedValues.AddRange(found);
    }
}

Imports Spire.Pdf
Imports Spire.Barcode

Dim pdf As New PdfDocument()
pdf.LoadFromFile("invoices.pdf")

Dim scanner As New BarcodeScanner()
Dim extractedValues As New List(Of String)()

For Each page As PdfPageBase In pdf.Pages
    Dim images() As Image = page.ExtractImages()
    For Each image As Image In images
        Dim found() As String = scanner.Scan(image, BarCodeType.QRCode)
        extractedValues.AddRange(found)
    Next
Next

Abordagem do IronBarcode:

using IronBarCode;

var results = BarcodeReader.Read("invoices.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}");
}

using IronBarCode;

var results = BarcodeReader.Read("invoices.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}");
}

Imports IronBarCode

Dim results = BarcodeReader.Read("invoices.pdf")

For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}")
Next

IronBarcode lê documentos PDF diretamente sem exigir Spire.PDF ou qualquer gerenciamento manual de página. O número da página de onde cada código de barras foi extraído está disponível no objeto de resultado. Uma vez que o código de leitura de PDF é substituído, a referência de pacote Spire.PDF e todas as importações using Spire.Pdf; podem ser removidas do projeto.

Problema 1: Remoção do parâmetro BarCodeType

Spire.Barcode: scanner.Scan(path, BarCodeType.Code128) — o argumento de tipo é obrigatório pela assinatura do método. Remover esse elemento causa um erro de compilação.

Solução: Substitua toda a chamada por BarcodeReader.Read(path). Pesquise na base de código por BarCodeType. para localizar todas as ocorrências. Loops de suposição de tipo (blocos foreach iterando sobre um array candidato BarCodeType[]) podem ser excluídos por inteiro; uma única chamada BarcodeReader.Read() substitui o loop.

Problema 2: Tipo de retorno string[]

Spire.Barcode: Scan() returns string[]. O código subsequente que atribui isso a uma variável string[] ou passa para um método que espera string[] falhará na compilação após a migração.

Solução: Atualize os locais de chamada para trabalhar com BarcodeResults. Para obter um array de strings simples, use .Select(r => r.Value).ToArray(). Para acessar o primeiro resultado, use .First()?.Value. Se o formato detectado for necessário posteriormente, ele está disponível no objeto resultante por meio de .Format — nenhuma variável de estado separada é necessária.

// If a plain string array is needed:
string[] texts = BarcodeReader.Read("barcode.png")
    .Select(r => r.Value)
    .ToArray();

// If only the first value is needed:
string first = BarcodeReader.Read("barcode.png").First()?.Value;

// If a plain string array is needed:
string[] texts = BarcodeReader.Read("barcode.png")
    .Select(r => r.Value)
    .ToArray();

// If only the first value is needed:
string first = BarcodeReader.Read("barcode.png").First()?.Value;

Imports System.Linq

' If a plain string array is needed:
Dim texts As String() = BarcodeReader.Read("barcode.png") _
    .Select(Function(r) r.Value) _
    .ToArray()

' If only the first value is needed:
Dim first As String = BarcodeReader.Read("barcode.png").FirstOrDefault()?.Value

Problema 3: Limpeza do pacote Spire.PDF

Spire.Barcode: Os fluxos de trabalho de leitura de PDF dependem de Spire.PDF para acesso às páginas e extração de imagens. O projeto faz referência ao pacote e contém importações using Spire.Pdf; e uso PdfDocument / PdfPageBase espalhados por vários arquivos.

Solução: Após substituir todo o código de extração de código de barras do PDF por BarcodeReader.Read("file.pdf"), execute uma auditoria grep para confirmar que não existem mais referências Spire.Pdf antes de remover o pacote:

grep -r "using Spire.Pdf" --include="*.cs" .
grep -r "Spire\.Pdf\|PdfPageBase\|ExtractImages" --include="*.cs" .

grep -r "using Spire.Pdf" --include="*.cs" .
grep -r "Spire\.Pdf\|PdfPageBase\|ExtractImages" --include="*.cs" .

Remova o pacote somente quando todas as referências forem removidas:

dotnet remove package Spire.PDF

dotnet remove package Spire.PDF

Problema 4: Alterações no espaço de nomes

Spire.Barcode: The Spire.Barcode namespace contains BarcodeScanner, BarcodeSettings, BarCodeGenerator, and BarCodeType. O namespace IronBarCode contém BarcodeReader, BarcodeWriter, BarcodeEncoding e BarcodeReaderOptions.

Solução: Substitua using Spire.Barcode; por using IronBarCode; globalmente. O enum BarCodeType usado na geração é substituído por BarcodeEncoding. O enum BarCodeType usado na leitura não tem equivalente no IronBarcode— ele é simplesmente removido, pois a detecção de formato é automática.

Tarefas pré-migração

Antes de fazer alterações, audite o código-fonte para identificar todos os usos de Spire.Barcode:

grep -r "using Spire.Barcode" --include="*.cs" .
grep -r "using Spire.Pdf" --include="*.cs" .
grep -r "BarcodeScanner\|BarcodeSettings\|BarCodeGenerator\|BarCodeType\." --include="*.cs" .
grep -r "ApplyKey\|SetLicenseKey" --include="*.cs" .
grep -r "ExtractImages\|PdfPageBase" --include="*.cs" .

grep -r "using Spire.Barcode" --include="*.cs" .
grep -r "using Spire.Pdf" --include="*.cs" .
grep -r "BarcodeScanner\|BarcodeSettings\|BarCodeGenerator\|BarCodeType\." --include="*.cs" .
grep -r "ApplyKey\|SetLicenseKey" --include="*.cs" .
grep -r "ExtractImages\|PdfPageBase" --include="*.cs" .

• Documente todos os arquivos que contenham arrays candidatos BarCodeType (loops de suposição de tipo a serem removidos)
• Identifique quaisquer variáveis string[] que recebam resultados de Scan() e precisarão de atualizações de tipo
• Confirme se Spire.PDF é usado para operações além da extração de código de barras

Tarefas de atualização de código

1. Remova o pacote NuGet FreeSpire.Barcode ou Spire.Barcode
2. Remova o pacote NuGet Spire.PDF se a extração de código de barras fosse seu único uso
3. Instale o pacote NuGet IronBarcode
4. Substitua todos os using Spire.Barcode; por using IronBarCode;
5. Remova todas as importações using Spire.Pdf; onde não forem mais necessárias
6. Substitua a inicialização da licença: ApplyKey() ou SetLicenseKey() por IronBarCode.License.LicenseKey = "key"
7. Remova todas as instanciações new BarcodeScanner()
8. Substitua todas as chamadas scanner.Scan(path, BarCodeType.X) por BarcodeReader.Read(path)
9. Elimine os loops foreach que tentam adivinhar o tipo de dado; substitua cada uma por uma única chamada BarcodeReader.Read()
10. Remover os blocos de iteração de página PDF e extração de imagem; substitua por BarcodeReader.Read("file.pdf")
11. Atualize as atribuições de resultado string[] para usar .Value ou .Select(r => r.Value).ToArray()
12. Substitua blocos new BarcodeSettings() por cadeias BarcodeWriter.CreateBarcode(data, encoding)
13. Remova as instanciações new BarCodeGenerator(settings)
14. Substitua .GenerateImage() + image.Save() por .SaveAsPng() ou .SaveAsJpeg()
15. Substitua os valores de enumerações BarCodeType.X na geração por BarcodeEncoding.X

Testes pós-migração

• Confirme se todos os formatos escaneados anteriormente através do loop candidato são detectados corretamente por BarcodeReader.Read()
• Medir a capacidade de processamento em lote e confirmar se ela atende aos requisitos de produção.
• Verificar se a extração do código de barras do PDF produz valores e números de página corretos.
• Confirme a qualidade e a legibilidade do código de barras gerado com um leitor físico ou de software.
• Verifique se a chave de licença está corretamente carregada em todos os ambientes de implantação (local, teste, produção, CI/CD). Execute os comandos grep audit das Tarefas de Pré-Migração para confirmar que não restam referências ao Spire.