Aspose.BarCode for .NET vs IronBarcode: Comparação de bibliotecas de código de barras em C#

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:

// Aspose.BarCode: must specify format or use slow AllSupportedTypes
using Aspose.BarCode.BarCodeRecognition;

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

// Aspose.BarCode: must specify format or use slow AllSupportedTypes
using Aspose.BarCode.BarCodeRecognition;

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

Imports Aspose.BarCode.BarCodeRecognition

' Aspose.BarCode: must specify format or use slow AllSupportedTypes
Dim reader As New BarCodeReader("barcode.png", DecodeType.Code128)
reader.ReadBarCodes()
For Each result In reader.FoundBarCodes
    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 é a alternativa, e é significativamente mais lento do que uma lista de tipos de decodificação direcionada.

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 o IDisposable, embora as consequências de não o descartar sejam menos graves. 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 normalmente requer navegar até 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)

Cada personalização navega até generator.Parameters.Barcode.*, que é uma hierarquia de objetos multinível. 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")

O Aspose.BarCode requer desenho manual em GDI+ para sobrepor um logotipo em um código QR — gerando a imagem do código de barras e, em seguida, usando System.Drawing.Graphics para compor o logotipo centralizado sobre ela. O recurso AddBrandLogo doIronBarcodelida com isso em uma única chamada e configura automaticamente a correção de erros de forma adequada.

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. Em conjunto, isso representa um custo de US$ 1.998 a US$ 9.990 por ano para o que a maioria dos desenvolvedores considera uma única funcionalidade.

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

Isso envolve duas configurações de licença, duas declarações using de dois namespaces, um pipeline de renderização, gerenciamento de fluxo de memória e um loop aninhado. Também utiliza DecodeType.AllSupportedTypes porque, no momento da extração da imagem, normalmente não se sabe qual formato o código de barras utiliza.

Abordagem do IronBarcode

OIronBarcodelida 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ódigo 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;

// AllSupportedTypes scans for every known format — significantly slower
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;

// AllSupportedTypes scans for every known format — significantly slower
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

' AllSupportedTypes scans for every known format — significantly slower
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 doIronBarcodeutiliza o mesmo algoritmo, independentemente de a imagem conter um código Code 128 ou um DataMatrix. Se você deseja ajustar a relação entre desempenho e precisão, a opção ReadingSpeed faz isso sem exigir conhecimento do 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 a taxa de transferência. ReadingSpeed.Detailed prioriza a precisão em imagens danificadas ou com 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 o Aspose.BarCode for o único produto Aspose na pilha, o preço de US$ 999 a US$ 4.995 por ano para a funcionalidade de código de barras exige uma comparação. A conversa geralmente é assim: "Vamos pagar isso todo ano, para sempre." Qual o custo inicial doIronBarcode? Não plano Professional (US$ 2.999 para 10 desenvolvedores), oIronBarcodese paga no primeiro ano com a licença Site.

Para equipes que utilizam o Aspose.Total — onde o Aspose.BarCode vem incluído em mais de 20 outros produtos — o cálculo é diferente. 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 a necessidade imediata, mas dobra o custo da assinatura. 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 oIronBarcodelê 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 o aplicativo foi desenvolvido considerando entradas do código 128 e um cliente carrega um rótulo DataMatrix, um valor fixo como DecodeType.Code128 simplesmente não retornará nenhum resultado. A alteração para DecodeType.AllSupportedTypes corrige o problema, mas introduz um custo de desempenho.

As equipes que se depararam com esse problema — adicionar cada vez mais valores DecodeType à configuração do leitor à medida que novos formatos surgem em produção — muitas vezes acabam mantendo uma lista que precisa ser atualizada sempre que uma nova fonte de formato é adicionada. A detecção automática doIronBarcodetorna 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 doIronBarcodese 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 @@--CÓDIGO-63308--@@ 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 torna-se result.Value. @@--CÓDIGO-63310--@@ torna-se result.Format.ToString(). A propriedade result.Format é um valor de enumeração BarcodeEncoding, que também permite comparações tipadas quando necessário.

Remoção do tipo de decodificação

Todas as referências a DecodeType.* no código-fonte podem ser removidas:

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 do formato.

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

Aspose.BarCode usa um arquivo .lic carregado via license.SetLicense().IronBarcodeusa 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 compilação. Não Docker, remova a linha COPY Aspose.BarCode.lic e substitua-a por uma entrada ENV IRONBARCODE_LICENSE.

Mapeamento de EncodeTypes para BarcodeEncoding

EncodeTypes.QR corresponde a BarcodeEncoding.QRCode — a diferença de nomenclatura é onde as equipes geralmente encontram o primeiro erro de compilação após migrar o código de geração. Todas as outras correspondências são equivalentes diretas com nomenclatura consistente.