Qual biblioteca de código de barras C# você deve usar para desenvolvimento .NET?

O Modelo de Leitura Centrada no Formato

A API de leitura do Aspose.BarCode é construída partindo do pressuposto de que o chamador conhece o formato do código de barras:

using Aspose.BarCode.BarCodeRecognition;

var reader = new BarCodeReader("barcode.png", DecodeType.Code128);
foreach (var result in reader.ReadBarCodes())
    Console.WriteLine($"{result.CodeTypeName}: {result.CodeText}");

using Aspose.BarCode.BarCodeRecognition;

var reader = new BarCodeReader("barcode.png", DecodeType.Code128);
foreach (var result in reader.ReadBarCodes())
    Console.WriteLine($"{result.CodeTypeName}: {result.CodeText}");

Imports Aspose.BarCode.BarCodeRecognition

Dim reader As New BarCodeReader("barcode.png", DecodeType.Code128)
For Each result In reader.ReadBarCodes()
    Console.WriteLine($"{result.CodeTypeName}: {result.CodeText}")
Next

Quando você conhece o formato, esse padrão funciona bem. O problema é justamente esse "conhecimento do formato". Um sistema de compras que processa faturas de fornecedores não pode garantir que todos os fornecedores usem o mesmo tipo de código de barras. Um sistema de gerenciamento de documentos que aceita uploads de usuários não pode prever qual formato um scanner utilizou. Nesses casos, DecodeType.AllSupportedTypes é o fallback, e é tipicamente mais lento do que uma lista direcionada de tipos de decodificação.

O decodificador também deve ser descartado:

using var reader = new BarCodeReader("barcode.png", DecodeType.Code128);

using var reader = new BarCodeReader("barcode.png", DecodeType.Code128);

Não usar using é um vazamento de recursos. O BarcodeGenerator também implementa IDisposable, embora as consequências de não descartá-lo sejam menos severas. Em ambos os casos, você está gerenciando o ciclo de vida dos objetos, algo que uma API de fábrica estática faria automaticamente.

Comparação Detalhada de Recursos

Abordagem Aspose.BarCode

Aspose.BarCode usa uma classe BarcodeGenerator com uma hierarquia Parameters para configuração. Uma chamada de geração mínima requer três etapas: instanciação, chamada de salvamento e especificação de formato. O uso real tipicamente requer navegar em generator.Parameters.Barcode.*:

using Aspose.BarCode.Generation;
using System.Drawing;

var generator = new BarcodeGenerator(EncodeTypes.Code128, "ITEM-12345");

// Common customizations require navigating a deep parameter hierarchy
generator.Parameters.Barcode.XDimension.Pixels = 2;
generator.Parameters.Barcode.BarHeight.Pixels = 100;
generator.Parameters.Barcode.CodeTextParameters.Location = CodeLocation.Below;
generator.Parameters.Barcode.CodeTextParameters.Font.FamilyName = "Arial";
generator.Parameters.Barcode.Padding.Left.Pixels = 10;
generator.Parameters.Barcode.Padding.Right.Pixels = 10;
generator.Parameters.BackColor = Color.White;
generator.Parameters.Resolution = 300;

generator.Save("barcode.png", BarCodeImageFormat.Png);

using Aspose.BarCode.Generation;
using System.Drawing;

var generator = new BarcodeGenerator(EncodeTypes.Code128, "ITEM-12345");

// Common customizations require navigating a deep parameter hierarchy
generator.Parameters.Barcode.XDimension.Pixels = 2;
generator.Parameters.Barcode.BarHeight.Pixels = 100;
generator.Parameters.Barcode.CodeTextParameters.Location = CodeLocation.Below;
generator.Parameters.Barcode.CodeTextParameters.Font.FamilyName = "Arial";
generator.Parameters.Barcode.Padding.Left.Pixels = 10;
generator.Parameters.Barcode.Padding.Right.Pixels = 10;
generator.Parameters.BackColor = Color.White;
generator.Parameters.Resolution = 300;

generator.Save("barcode.png", BarCodeImageFormat.Png);

Imports Aspose.BarCode.Generation
Imports System.Drawing

Dim generator As New BarcodeGenerator(EncodeTypes.Code128, "ITEM-12345")

' Common customizations require navigating a deep parameter hierarchy
generator.Parameters.Barcode.XDimension.Pixels = 2
generator.Parameters.Barcode.BarHeight.Pixels = 100
generator.Parameters.Barcode.CodeTextParameters.Location = CodeLocation.Below
generator.Parameters.Barcode.CodeTextParameters.Font.FamilyName = "Arial"
generator.Parameters.Barcode.Padding.Left.Pixels = 10
generator.Parameters.Barcode.Padding.Right.Pixels = 10
generator.Parameters.BackColor = Color.White
generator.Parameters.Resolution = 300

generator.Save("barcode.png", BarCodeImageFormat.Png)

Toda personalização navega em generator.Parameters.Barcode.*, que é uma hierarquia de objetos em múltiplos níveis. Não é complexo depois de memorizado, mas requer memorização.

Abordagem do IronBarcode

IronBarcode substitui a hierarquia de parâmetros por uma cadeia de métodos fluente. As configurações padrão produzem resultados corretos para a maioria dos casos de uso, e a personalização é expressa diretamente no código:

using IronBarCode;

// Default settings work for most cases
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// Customization through a fluent chain
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

// Get as bytes instead of saving to disk
byte[] pngData = BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
    .ToPngBinaryData();

using IronBarCode;

// Default settings work for most cases
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// Customization through a fluent chain
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

// Get as bytes instead of saving to disk
byte[] pngData = BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
    .ToPngBinaryData();

Imports IronBarCode

' Default settings work for most cases
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128) _
    .SaveAsPng("barcode.png")

' Customization through a fluent chain
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("barcode.png")

' Get as bytes instead of saving to disk
Dim pngData As Byte() = BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128) _
    .ToPngBinaryData()

Para códigos QR, a API de geração de QR Codes da IronBarcode inclui suporte para logotipos de marcas sem a necessidade de composição manual de imagens:

using IronBarCode;
using IronSoftware.Drawing;

// With brand logo — built in, no manual image overlay needed
QRCodeWriter.CreateQrCode("https://example.com", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

// With high error correction (recommended when using a logo)
QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded-high-ecc.png");

// Colored QR code
QRCodeWriter.CreateQrCode("https://example.com", 300)
    .ChangeBarCodeColor(Color.DarkBlue)
    .SaveAsPng("qr-colored.png");

using IronBarCode;
using IronSoftware.Drawing;

// With brand logo — built in, no manual image overlay needed
QRCodeWriter.CreateQrCode("https://example.com", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

// With high error correction (recommended when using a logo)
QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded-high-ecc.png");

// Colored QR code
QRCodeWriter.CreateQrCode("https://example.com", 300)
    .ChangeBarCodeColor(Color.DarkBlue)
    .SaveAsPng("qr-colored.png");

Imports IronBarCode
Imports IronSoftware.Drawing

' With brand logo — built in, no manual image overlay needed
QRCodeWriter.CreateQrCode("https://example.com", 500) _
    .AddBrandLogo("logo.png") _
    .SaveAsPng("qr-branded.png")

' With high error correction (recommended when using a logo)
QRCodeWriter.CreateQrCode( _
    "https://example.com", _
    500, _
    QRCodeWriter.QrErrorCorrectionLevel.Highest) _
    .AddBrandLogo("logo.png") _
    .SaveAsPng("qr-branded-high-ecc.png")

' Colored QR code
QRCodeWriter.CreateQrCode("https://example.com", 300) _
    .ChangeBarCodeColor(Color.DarkBlue) _
    .SaveAsPng("qr-colored.png")

Aspose.BarCode não fornece um assistente de logotipo de marca em uma única chamada para QR codes; a abordagem documentada é gerar a imagem do código de barras e então compor o logotipo sobre ela (por exemplo, com System.Drawing.Graphics). O AddBrandLogo do IronBarcode lida com o composto em uma única chamada e define automaticamente a correção de erro apropriadamente.

Abordagem Aspose.BarCode

O Aspose.BarCode não possui suporte nativo para PDF. Para ler um código de barras de um PDF com o Aspose, você precisa do Aspose.PDF para carregar o PDF e renderizar as páginas em imagens, e do Aspose.BarCode para ler essas imagens renderizadas. Ambos são produtos por assinatura. Ambos precisam de ativação de licença. Você está pagando duas assinaturas anuais por algo que a maioria dos desenvolvedores considera como uma única capacidade.

// Requires both Aspose.PDF (separate license) and Aspose.BarCode
using Aspose.Pdf;
using Aspose.Pdf.Devices;
using Aspose.BarCode.BarCodeRecognition;
using System.IO;

public List<string> ReadBarcodesFromPdf(string pdfPath)
{
    var barcodeValues = new List<string>();

    // Step 1: Load and render the PDF using Aspose.PDF
    var pdfDocument = new Aspose.Pdf.Document(pdfPath);
    var resolution = new Resolution(300);
    var device = new PngDevice(resolution);

    for (int pageNum = 1; pageNum <= pdfDocument.Pages.Count; pageNum++)
    {
        using var pageStream = new MemoryStream();
        device.Process(pdfDocument.Pages[pageNum], pageStream);
        pageStream.Seek(0, SeekOrigin.Begin);

        // Step 2: Scan the rendered image for barcodes using Aspose.BarCode
        using var reader = new BarCodeReader(pageStream, DecodeType.AllSupportedTypes);
        foreach (var result in reader.ReadBarCodes())
        {
            barcodeValues.Add(result.CodeText);
        }
    }

    return barcodeValues;
}

// Requires both Aspose.PDF (separate license) and Aspose.BarCode
using Aspose.Pdf;
using Aspose.Pdf.Devices;
using Aspose.BarCode.BarCodeRecognition;
using System.IO;

public List<string> ReadBarcodesFromPdf(string pdfPath)
{
    var barcodeValues = new List<string>();

    // Step 1: Load and render the PDF using Aspose.PDF
    var pdfDocument = new Aspose.Pdf.Document(pdfPath);
    var resolution = new Resolution(300);
    var device = new PngDevice(resolution);

    for (int pageNum = 1; pageNum <= pdfDocument.Pages.Count; pageNum++)
    {
        using var pageStream = new MemoryStream();
        device.Process(pdfDocument.Pages[pageNum], pageStream);
        pageStream.Seek(0, SeekOrigin.Begin);

        // Step 2: Scan the rendered image for barcodes using Aspose.BarCode
        using var reader = new BarCodeReader(pageStream, DecodeType.AllSupportedTypes);
        foreach (var result in reader.ReadBarCodes())
        {
            barcodeValues.Add(result.CodeText);
        }
    }

    return barcodeValues;
}

Imports Aspose.Pdf
Imports Aspose.Pdf.Devices
Imports Aspose.BarCode.BarCodeRecognition
Imports System.IO

Public Function ReadBarcodesFromPdf(pdfPath As String) As List(Of String)
    Dim barcodeValues As New List(Of String)()

    ' Step 1: Load and render the PDF using Aspose.PDF
    Dim pdfDocument As New Aspose.Pdf.Document(pdfPath)
    Dim resolution As New Resolution(300)
    Dim device As New PngDevice(resolution)

    For pageNum As Integer = 1 To pdfDocument.Pages.Count
        Using pageStream As New MemoryStream()
            device.Process(pdfDocument.Pages(pageNum), pageStream)
            pageStream.Seek(0, SeekOrigin.Begin)

            ' Step 2: Scan the rendered image for barcodes using Aspose.BarCode
            Using reader As New BarCodeReader(pageStream, DecodeType.AllSupportedTypes)
                For Each result In reader.ReadBarCodes()
                    barcodeValues.Add(result.CodeText)
                Next
            End Using
        End Using
    Next

    Return barcodeValues
End Function

São duas configurações de licença, duas declarações de uso de dois namespaces, um pipeline de renderização, gerenciamento de fluxo de memória e um loop aninhado. Ele também usa DecodeType.AllSupportedTypes porque no ponto de extração da imagem você tipicamente não sabe qual formato o código de barras utiliza.

Abordagem do IronBarcode

O IronBarcode lida internamente com a análise de PDFs, a renderização de páginas e a detecção de códigos de barras. Você chama Read com um caminho que termina em .pdf, e ele retorna resultados de códigos de barras que incluem result.PageNumber para que você saiba de qual página cada um veio. Sem segundo pacote, sem segunda licença, sem código de renderização.

using IronBarCode;

public List<string> ReadBarcodesFromPdf(string pdfPath)
{
    var results = BarcodeReader.Read(pdfPath);
    return results.Select(r => r.Value).ToList();
}

using IronBarCode;

public List<string> ReadBarcodesFromPdf(string pdfPath)
{
    var results = BarcodeReader.Read(pdfPath);
    return results.Select(r => r.Value).ToList();
}

Imports IronBarCode

Public Function ReadBarcodesFromPdf(pdfPath As String) As List(Of String)
    Dim results = BarcodeReader.Read(pdfPath)
    Return results.Select(Function(r) r.Value).ToList()
End Function

// With page number context
var results = BarcodeReader.Read("invoice-batch.pdf");
foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: [{barcode.Format}] {barcode.Value}");
}

// With page number context
var results = BarcodeReader.Read("invoice-batch.pdf");
foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: [{barcode.Format}] {barcode.Value}");
}

Imports System

' With page number context
Dim results = BarcodeReader.Read("invoice-batch.pdf")
For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: [{barcode.Format}] {barcode.Value}")
Next

A documentação de leitura de PDFs do IronBarcode abrange o processamento em lote de várias páginas e as opções de filtragem por intervalo de páginas.

Abordagem Aspose.BarCode

DecodeType.AllSupportedTypes é a solução da Aspose para cenários de formato desconhecido. A própria documentação da Aspose reconhece que esse método é mais lento do que especificar uma lista de alvos, porque o decodificador percorre sequencialmente todas as simbologias conhecidas. Para processamento de alto volume — um armazém escaneando milhares de etiquetas por minuto — essa diferença de desempenho não é trivial.

using Aspose.BarCode.BarCodeRecognition;

using var reader = new BarCodeReader("unknown-format.png");
reader.SetBarCodeReadType(DecodeType.AllSupportedTypes);
foreach (var result in reader.ReadBarCodes())
{
    Console.WriteLine($"{result.CodeTypeName}: {result.CodeText}");
}

using Aspose.BarCode.BarCodeRecognition;

using var reader = new BarCodeReader("unknown-format.png");
reader.SetBarCodeReadType(DecodeType.AllSupportedTypes);
foreach (var result in reader.ReadBarCodes())
{
    Console.WriteLine($"{result.CodeTypeName}: {result.CodeText}");
}

Imports Aspose.BarCode.BarCodeRecognition

Using reader As New BarCodeReader("unknown-format.png")
    reader.SetBarCodeReadType(DecodeType.AllSupportedTypes)
    For Each result In reader.ReadBarCodes()
        Console.WriteLine($"{result.CodeTypeName}: {result.CodeText}")
    Next
End Using

Abordagem do IronBarcode

Não existe um "modo lento" e um "modo rápido" com base no conhecimento do formato. A detecção do IronBarcode utiliza o mesmo algoritmo, independentemente de a imagem conter um código Code 128 ou um DataMatrix. Se você quiser ajustar o equilíbrio entre desempenho e precisão, a opção ReadingSpeed faz isso sem exigir conhecimento de formato:

using IronBarCode;

// The same call regardless of format — always auto-detects
var results = BarcodeReader.Read("unknown-format.png");
foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

using IronBarCode;

// The same call regardless of format — always auto-detects
var results = BarcodeReader.Read("unknown-format.png");
foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

Imports IronBarCode

' The same call regardless of format — always auto-detects
Dim results = BarcodeReader.Read("unknown-format.png")
For Each result In results
    Console.WriteLine($"{result.Format}: {result.Value}")
Next

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

var results = BarcodeReader.Read("document.png", options);

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

var results = BarcodeReader.Read("document.png", options);

Imports IronBarCode

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .MaxParallelThreads = 4
}

Dim results = BarcodeReader.Read("document.png", options)

ReadingSpeed.Faster prioriza o rendimento. ReadingSpeed.Detailed prioriza a precisão em imagens danificadas ou de baixo contraste. Nenhuma delas exige que você conheça o formato com antecedência. Consulte as opções de leitura do IronBarcode para obter o conjunto completo de parâmetros de ajuste.

Chegou a hora de renovar a assinatura.

A renovação da assinatura anual é o período em que as equipes mais frequentemente revisam as decisões relativas à biblioteca. Se Aspose.BarCode for o único produto Aspose na pilha, pagar $999/ano por desenvolvedor (ou $4.995/ano no nível de site) para funcionalidade de códigos de barras incita uma comparação. A conversa geralmente é assim: "Vamos pagar isso todo ano, para sempre." Qual o custo inicial do IronBarcode? Não plano Professional (US$ 2.999 para 10 desenvolvedores), o IronBarcode se paga no primeiro ano com a licença Site.

Para equipes usando o Aspose.Total — onde o Aspose.BarCode é agrupado com muitos outros produtos Aspose — os cálculos são diferentes. O custo marginal do Aspose.BarCode nesse pacote se aproxima de zero. Essas equipes têm menos motivos para mudar.

Suporte a PDF torna-se um requisito

Muitos projetos começam com a leitura de códigos de barras em imagens e, posteriormente, adicionam suporte a PDFs quando um dos envolvidos percebe que os documentos recebidos são PDFs em vez de arquivos de imagem. Nesse ponto, a equipe do Aspose.BarCode se depara com uma decisão: adicionar o Aspose.PDF (outra assinatura), encontrar um renderizador de PDF de terceiros ou reavaliar a biblioteca de código de barras.

Adicionar o Aspose.PDF resolve o requisito imediato, mas significa uma segunda assinatura anual. Encontrar um renderizador de terceiros adiciona uma dependência e um esforço de integração. Reavaliar a biblioteca de códigos de barras — e descobrir que o IronBarcode lê PDFs nativamente por uma taxa única — é frequentemente o resultado.

Cenários de formato desconhecido em produção

Aplicativos voltados para o cliente que aceitam uploads de documentos não podem controlar qual formato de código de barras um documento carregado utiliza. Se a aplicação foi construída assumindo entradas Code 128 e um cliente fizer o upload de uma etiqueta DataMatrix, um DecodeType.Code128 codificado irá silenciosamente não retornar resultados. Mudar para DecodeType.AllSupportedTypes corrige a precisão, mas introduz um custo de desempenho.

As equipes que encontraram esse problema — adicionando mais e mais valores DecodeType à sua configuração de leitor conforme novos formatos aparecem na produção — frequentemente acabam mantendo uma lista que precisa ser atualizada toda vez que uma nova fonte de formato é adicionada. A detecção automática do IronBarcode torna essa lista desnecessária.

Implantações em nuvem e conteinerizadas

O licenciamento baseado em arquivo do Aspose.BarCode adiciona uma etapa de implantação: o arquivo de licença deve estar acessível em tempo de execução a partir de um caminho que o aplicativo possa ler. Em um fluxo de trabalho GitOps, o arquivo de licença acaba no controle de versão (um risco de segurança) ou precisa ser injetado por meio de um volume secreto montado. A abordagem baseada em chaves do IronBarcode se integra perfeitamente aos segredos do Kubernetes e às variáveis ​​secretas de CI/CD, sem a necessidade de gerenciar arquivos na imagem do contêiner.

Mapeamento de nomes de propriedades

O erro de compilação mais comum após a troca de pacotes é a renomeação de result.CodeText para result.Value. Uma busca em todo o código-fonte resolve isso rapidamente:

grep -r "\.CodeText" --include="*.cs" .
grep -r "\.CodeTypeName" --include="*.cs" .

grep -r "\.CodeText" --include="*.cs" .
grep -r "\.CodeTypeName" --include="*.cs" .

result.CodeText se torna result.Value. result.CodeTypeName se torna result.Format.ToString(). A propriedade result.Format é um valor enum BarcodeEncoding, que também permite comparações tipadas, onde necessário.

Remoção do tipo de decodificação

Toda referência DecodeType.* na base de código pode ser removida:

grep -r "DecodeType\." --include="*.cs" .

grep -r "DecodeType\." --include="*.cs" .

Se um DecodeType específico foi listado para melhorar o desempenho em um formato conhecido, ReadingSpeed.Faster em BarcodeReaderOptions fornece um benefício semelhante sem requisitos de conhecimento de formato.

Alteração de inicialização da licença

Aspose.BarCode usa um arquivo .lic carregado via license.SetLicense().IronBarcode usa uma chave de string:

IronBarCode.License.LicenseKey =
    Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE")
    ?? throw new InvalidOperationException("IronBarcode license key not configured");

IronBarCode.License.LicenseKey =
    Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE")
    ?? throw new InvalidOperationException("IronBarcode license key not configured");

Imports IronBarCode
Imports System

License.LicenseKey = If(Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE"), Throw New InvalidOperationException("IronBarcode license key not configured"))

Remova o arquivo .lic do repositório e dos artefatos de construção. Não Docker, remova a linha COPY Aspose.BarCode.lic e substitua por uma entrada ENV IRONBARCODE_LICENSE.

Mapeamento de EncodeTypes para BarcodeEncoding

EncodeTypes.QR mapeia para BarcodeEncoding.QRCode — a diferença de nome é onde as equipes frequentemente encontram o primeiro erro de compilação após migrar o código de geração. A maioria dos outros mapeamentos são equivalentes diretos com nomenclatura consistente.