NetBarcode vs IronBarcode: Comparação de bibliotecas de código de barras em C#

O Limite de Projeto do Enum Tipo

A enumeração Type é a lista definitiva do que o NetBarcode pode gerar. Ao inspecioná-la, revela-se a abrangência da biblioteca:

// NetBarcode Type enum — complete list as of v1.8
public enum Type
{
    Code128,
    Code128A,
    Code128B,
    Code128C,
    Code39,
    Code39Extended,
    Code93,
    EAN8,
    EAN13,
    UPCA,
    UPCE,
    Codabar,
    ITF,
    MSI
}

// These entries do not exist — attempting to use them produces a CS0117 compile error:
// Type.QRCode      — does not exist
// Type.DataMatrix  — does not exist
// Type.PDF417      — does not exist
// Type.Aztec       — does not exist

// NetBarcode Type enum — complete list as of v1.8
public enum Type
{
    Code128,
    Code128A,
    Code128B,
    Code128C,
    Code39,
    Code39Extended,
    Code93,
    EAN8,
    EAN13,
    UPCA,
    UPCE,
    Codabar,
    ITF,
    MSI
}

// These entries do not exist — attempting to use them produces a CS0117 compile error:
// Type.QRCode      — does not exist
// Type.DataMatrix  — does not exist
// Type.PDF417      — does not exist
// Type.Aztec       — does not exist

Public Enum Type
    Code128
    Code128A
    Code128B
    Code128C
    Code39
    Code39Extended
    Code93
    EAN8
    EAN13
    UPCA
    UPCE
    Codabar
    ITF
    MSI
End Enum

' These entries do not exist — attempting to use them produces a BC30456 compile error:
' Type.QRCode      — does not exist
' Type.DataMatrix  — does not exist
' Type.PDF417      — does not exist
' Type.Aztec       — does not exist

Esta não é uma funcionalidade ausente que aguarda uma solicitação de pull request. O enum possui quatorze entradas, todas unidimensionais, o que reflete o escopo pretendido da biblioteca. Qualquer aplicação que exija códigos QR, DataMatrix, PDF417 ou asteca deve obter um pacote separado para fornecer esses formatos.

Comparação Detalhada de Recursos

Abordagem NetBarcode

O NetBarcode fornece 14 formatos de código de barras lineares através da enumeração Type. Nesse contexto, a seleção do formato é simples — basta passar o membro de enumeração apropriado para o construtor. O limite é igualmente claro: tentar usar um formato fora do enum produz um erro de compilação.

// NetBarcode — formats that compile and produce output
using NetBarcode;

var code128 = new Barcode("12345678901234", Type.Code128);
code128.SaveImageFile("shipping.png");

var ean13 = new Barcode("5901234123457", Type.EAN13);
ean13.SaveImageFile("product.png");

// NetBarcode — formats that produce CS0117 compile errors
// var qr     = new Barcode("data", Type.QRCode);     // error CS0117
// var dm     = new Barcode("data", Type.DataMatrix);  // error CS0117
// var p417   = new Barcode("data", Type.PDF417);      // error CS0117
// var aztec  = new Barcode("data", Type.Aztec);       // error CS0117

// NetBarcode — formats that compile and produce output
using NetBarcode;

var code128 = new Barcode("12345678901234", Type.Code128);
code128.SaveImageFile("shipping.png");

var ean13 = new Barcode("5901234123457", Type.EAN13);
ean13.SaveImageFile("product.png");

// NetBarcode — formats that produce CS0117 compile errors
// var qr     = new Barcode("data", Type.QRCode);     // error CS0117
// var dm     = new Barcode("data", Type.DataMatrix);  // error CS0117
// var p417   = new Barcode("data", Type.PDF417);      // error CS0117
// var aztec  = new Barcode("data", Type.Aztec);       // error CS0117

Imports NetBarcode

Dim code128 As New Barcode("12345678901234", Type.Code128)
code128.SaveImageFile("shipping.png")

Dim ean13 As New Barcode("5901234123457", Type.EAN13)
ean13.SaveImageFile("product.png")

' NetBarcode — formats that produce CS0117 compile errors
' Dim qr As New Barcode("data", Type.QRCode)     ' error CS0117
' Dim dm As New Barcode("data", Type.DataMatrix) ' error CS0117
' Dim p417 As New Barcode("data", Type.PDF417)   ' error CS0117
' Dim aztec As New Barcode("data", Type.Aztec)   ' error CS0117

Em setores onde essa limitação se torna um problema, incluem-se o rastreamento de produtos farmacêuticos (DataMatrix exigido pelas normas de código de barras 2D da FDA), cartões de embarque de companhias aéreas (Aztec), manifestos logísticos (PDF417) e marketing móvel (código QR). Cada um desses requisitos elimina o NetBarcode como uma solução independente.

Abordagem do IronBarcode

IronBarcode expõe todos os formatos suportados através do mesmo método BarcodeWriter.CreateBarcode. A superfície da API não muda ao passar de um formato 1D para um formato 2D — apenas a constante BarcodeEncoding difere.

using IronBarCode;

// 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("shipping.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product.png");

// 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-label.png");

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec)
    .SaveAsPng("boarding-pass.png");

using IronBarCode;

// 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("shipping.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product.png");

// 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-label.png");

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec)
    .SaveAsPng("boarding-pass.png");

Imports IronBarCode

' 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128) _
    .SaveAsPng("shipping.png")

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13) _
    .SaveAsPng("product.png")

' 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .SaveAsPng("qr.png")

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix) _
    .SaveAsPng("pharma-label.png")

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec) _
    .SaveAsPng("boarding-pass.png")

A lista completa de constantes suportadas está disponível na referência de formatos de código de barras suportados , abrangendo todos os formatos de geração de código de barras 2D, além do conjunto completo de códigos de barras 1D.

Abordagem NetBarcode

O modelo de geração do NetBarcode é baseado em construtores. Um objeto Barcode é instanciado com a string de dados e um valor de enumeração Type. A saída é salva diretamente com SaveImageFile() ou recuperada como um Image<Rgba32> via GetImage(). Desde a versão 1.8, o tipo de retorno de GetImage() é o tipo SixLabors.ImageSharp, o que significa que qualquer código que armazene ou processe o valor de retorno deve importar e funcionar dentro da API ImageSharp.

using NetBarcode;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

// Constructor-based creation
var barcode = new Barcode("12345678901234", Type.Code128);

// Save to file — straightforward
barcode.SaveImageFile("code128.png");

// GetImage() returns Image<Rgba32> — ImageSharp import required
Image<Rgba32> image = barcode.GetImage();

// Further processing requires familiarity with the ImageSharp API
using var stream = new MemoryStream();
image.SaveAsPng(stream);
byte[] bytes = stream.ToArray();

using NetBarcode;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

// Constructor-based creation
var barcode = new Barcode("12345678901234", Type.Code128);

// Save to file — straightforward
barcode.SaveImageFile("code128.png");

// GetImage() returns Image<Rgba32> — ImageSharp import required
Image<Rgba32> image = barcode.GetImage();

// Further processing requires familiarity with the ImageSharp API
using var stream = new MemoryStream();
image.SaveAsPng(stream);
byte[] bytes = stream.ToArray();

Imports NetBarcode
Imports SixLabors.ImageSharp
Imports SixLabors.ImageSharp.PixelFormats
Imports System.IO

' Constructor-based creation
Dim barcode As New Barcode("12345678901234", Type.Code128)

' Save to file — straightforward
barcode.SaveImageFile("code128.png")

' GetImage() returns Image(Of Rgba32) — ImageSharp import required
Dim image As Image(Of Rgba32) = barcode.GetImage()

' Further processing requires familiarity with the ImageSharp API
Using stream As New MemoryStream()
    image.SaveAsPng(stream)
    Dim bytes As Byte() = stream.ToArray()
End Using

O tipo de retorno do método GetImage() vincula o código subsequente à biblioteca ImageSharp. Qualquer método que aceite ou armazene o resultado deve declará-lo como Image<Rgba32>, introduzindo uma dependência transitiva no código de chamada.

Abordagem do IronBarcode

IronBarcode utiliza uma cadeia fluente. BarcodeWriter.CreateBarcode retorna um objeto GeneratedBarcode que contém múltiplos métodos de saída. O processamento de imagens é interno — nenhum tipo ImageSharp é exposto ao código que faz a chamada.

using IronBarCode;

// Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("code128.png");

// Multiple output options on the same GeneratedBarcode object
var barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128);
barcode.SaveAsPng("code128.png");
barcode.SaveAsJpeg("code128.jpg");
byte[] bytes = barcode.ToPngBinaryData();

using var stream = new MemoryStream();
barcode.SaveAsPng(stream);

using IronBarCode;

// Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("code128.png");

// Multiple output options on the same GeneratedBarcode object
var barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128);
barcode.SaveAsPng("code128.png");
barcode.SaveAsJpeg("code128.jpg");
byte[] bytes = barcode.ToPngBinaryData();

using var stream = new MemoryStream();
barcode.SaveAsPng(stream);

Imports IronBarCode

' Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128) _
    .SaveAsPng("code128.png")

' Multiple output options on the same GeneratedBarcode object
Dim barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
barcode.SaveAsPng("code128.png")
barcode.SaveAsJpeg("code128.jpg")
Dim bytes As Byte() = barcode.ToPngBinaryData()

Using stream As New MemoryStream()
    barcode.SaveAsPng(stream)
End Using

As opções detalhadas para geração de códigos de barras 1D, incluindo largura, altura e configuração de etiquetas, são abordadas na documentação doIronBarcode.

Abordagem NetBarcode

O NetBarcode não possui API de leitura. Não existe nenhum método, classe ou configuração que decodifique uma imagem de código de barras de volta para sua sequência de dados. Este é um limite de escopo deliberado, não uma omissão que se aguarda um lançamento. Um projeto que gera códigos de barras com o NetBarcode e posteriormente precisa lê-los — para validar uma etiqueta impressa, escanear uma remessa de devolução ou extrair valores de uma fatura de fornecedor — deve introduzir uma biblioteca separada para essa finalidade.

// NetBarcode — no reading method exists
// The following does not compile because the method does not exist:
// var result = barcode.Read("image.png");  // method does not exist

// The typical workaround requires ZXing.Net as a third-party dependency

// NetBarcode — no reading method exists
// The following does not compile because the method does not exist:
// var result = barcode.Read("image.png");  // method does not exist

// The typical workaround requires ZXing.Net as a third-party dependency

' NetBarcode — no reading method exists
' The following does not compile because the method does not exist:
' Dim result = barcode.Read("image.png")  ' method does not exist

' The typical workaround requires ZXing.Net as a third-party dependency

A biblioteca ZXing .NET é o complemento mais comum para leitura em conjunto com o NetBarcode, trazendo uma terceira interface de API e um terceiro pacote para gerenciar versões, além do NetBarcode e de qualquer biblioteca 2D já adicionada para códigos QR.

Abordagem do IronBarcode

IronBarcode inclui BarcodeReader no mesmo pacote que BarcodeWriter. A API de leitura aceita arquivos de imagem e documentos PDF e retorna uma coleção de resultados decodificados, cada um com o valor do código de barras, o tipo de formato e o número da página, caso a leitura seja feita a partir de um PDF.

using IronBarCode;

// Read barcodes from an image file
var imageResults = BarcodeReader.Read("shipping-label.png");
foreach (var r in imageResults)
{
    Console.WriteLine($"{r.BarcodeType}: {r.Value}");
}

// Read barcodes from a PDF document — no additional library required
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var r in pdfResults)
{
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}");
}

using IronBarCode;

// Read barcodes from an image file
var imageResults = BarcodeReader.Read("shipping-label.png");
foreach (var r in imageResults)
{
    Console.WriteLine($"{r.BarcodeType}: {r.Value}");
}

// Read barcodes from a PDF document — no additional library required
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var r in pdfResults)
{
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}");
}

Imports IronBarCode

' Read barcodes from an image file
Dim imageResults = BarcodeReader.Read("shipping-label.png")
For Each r In imageResults
    Console.WriteLine($"{r.BarcodeType}: {r.Value}")
Next

' Read barcodes from a PDF document — no additional library required
Dim pdfResults = BarcodeReader.Read("invoice.pdf")
For Each r In pdfResults
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}")
Next

O guia de leitura de códigos de barras a partir de imagens aborda o ajuste de velocidade, a detecção de múltiplos códigos de barras e as opções de correção de imagem disponíveis na API de leitura.

NetBarcode e ImageSharp

O NetBarcode possui licença MIT. A biblioteca SixLabors.ImageSharp, da qual depende, utiliza um modelo diferente: gratuita para projetos de código aberto e para empresas com receita bruta anual abaixo de um limite definido, mas uma licença comercial é necessária acima desse limite. Essa divisão se aplica independentemente de o ImageSharp estar listado explicitamente no .csproj de um projeto ou chegar transitivamente através do NetBarcode.

<PackageReference Include="NetBarcode" Version="1.8.2" />

<PackageReference Include="NetBarcode" Version="1.8.2" />

Para uma empresa de varejo ou logística que processa códigos de barras em grande escala — o principal caso de uso visado pela NetBarcode — a receita anual geralmente ultrapassa o limite a partir do qual a licença comercial da ImageSharp se aplica. Uma auditoria de conformidade pode revelar essa obrigação embutida na árvore de pacotes.

A versão 1.8 introduziu uma consequência adicional da dependência do ImageSharp: o tipo de retorno de GetImage() mudou de uma representação interna para SixLabors.ImageSharp.Image<Rgba32>. O código existente que chamava GetImage() sem tipagem explícita apresentou erros em tempo de compilação, e novas diretivas using para SixLabors.ImageSharp e SixLabors.ImageSharp.PixelFormats tornaram-se obrigatórias. Quando a API própria do ImageSharp evolui em versões futuras, a API pública do NetBarcode também será afetada.

Código de barras IronBarcode

IronBarcode não possui dependência de SixLabors.ImageSharp. Os termos de licenciamento estão descritos diretamente na página de licenciamento do IronBarcode, sem limite mínimo de licenciamento ou obrigação comercial transitiva. Uma chave de teste está disponível para avaliação; As licenças adquiridas removem a marca d'água de avaliação dos arquivos gerados.

Requisitos de formato para código QR e 2D

O fator que mais frequentemente motiva a avaliação de uma alternativa ao NetBarcode é uma nova exigência de códigos QR. Aplicações que começam com a geração de códigos de barras 1D para etiquetas de varejo ou manifestos de remessa geralmente recebem uma exigência subsequente de códigos QR — links sem contato, links diretos para aplicativos móveis, campanhas de marketing. Como a enumeração Type não possui uma entrada QR, esse requisito não pode ser atendido no NetBarcode. As equipes que adicionam uma biblioteca QR separada para suprir essa lacuna enfrentam uma segunda avaliação quando o DataMatrix é exigido para uma integração farmacêutica ou o PDF417 para uma transportadora logística que o exige nas etiquetas de envio.

A leitura de códigos de barras torna-se necessária

Alguns projetos começam com a geração pura e, posteriormente, adicionam um requisito de validação ou processamento de documentos: confirmar se um código de barras impresso corresponde aos seus dados de origem, extrair valores de código de barras de faturas de fornecedores recebidas ou digitalizar etiquetas de remessa de devolução. O NetBarcode não oferece nenhuma solução para isso. A adição do ZXing .NET ou de uma biblioteca de leitura comparável introduz uma terceira API para aprender e manter na mesma base de código que já contém o NetBarcode e uma biblioteca de QR Code. Projetos que preveem necessidades de leitura, mesmo em uma fase futura, muitas vezes consideram mais eficiente selecionar uma biblioteca que atenda a ambas as demandas desde o início.

Auditoria de Licença Comercial ImageSharp

Análises legais e de conformidade de dependências de terceiros ocasionalmente revelam a condição de licença comercial SixLabors.ImageSharp incorporada na árvore de pacotes do NetBarcode. Para empresas cujo faturamento bruto anual ultrapasse o limite, a obrigação se aplica independentemente de a ImageSharp ter sido escolhida deliberadamente ou ter chegado por meio da NetBarcode. As equipes que descobrem isso durante uma auditoria — em vez de antes da adoção — enfrentam uma correção retroativa em vez de uma migração planejada. Avaliar a licença de dependência antes de iniciar um projeto é o caminho mais correto.

Reduzindo a complexidade de múltiplas bibliotecas

Equipes que acumularam o NetBarcode para geração 1D, uma biblioteca específica para Código QR para saída 2D e o ZXing .NET para leitura, se veem na necessidade de manter a compatibilidade de versões entre três pacotes distintos. Cada ciclo de atualização exige a verificação se as três bibliotecas concordam com a versão compartilhada do ImageSharp. Cada novo desenvolvedor no projeto se depara com três APIs diferentes para o que, conceitualmente, é uma única preocupação. A consolidação em uma única biblioteca de códigos de barras simplifica a integração, reduz a superfície de conflito de versões e concentra a manutenção em um único ciclo de lançamento.

Troca de pacotes e limpeza de dependências transitivas

A remoção do NetBarcode com dotnet remove package NetBarcode é o primeiro passo. O pacote SixLabors.ImageSharp pode reaparecer na árvore de dependências se outros pacotes do projeto também o incluírem transitivamente. Após a remoção, inspecione a lista de pacotes restaurada com dotnet list package --include-transitive para confirmar se o ImageSharp ainda está presente e se a condição da licença comercial ainda se aplica.

Substituição do tipo de retorno de GetImage()

Qualquer código que tenha armazenado o resultado de GetImage() como Image<Rgba32> deve ser atualizado. O tipo ImageSharp não possui equivalente direto no IronBarcode; A substituição depende de como a imagem foi usada posteriormente. O código que salvou a imagem em um fluxo pode ser substituído por .SaveAsPng(stream) diretamente no objeto GeneratedBarcode. O código que recuperou bytes brutos pode usar .ToPngBinaryData(). O código que realizou manipulações adicionais do ImageSharp na imagem retornada precisará que essas operações sejam avaliadas individualmente.

Atualização de namespace

Os arquivos que importaram using NetBarcode;, using SixLabors.ImageSharp;, using SixLabors.ImageSharp.PixelFormats; ou using SixLabors.Fonts; precisam que essas diretivas sejam substituídas por using IronBarCode;. Uma busca em todo o projeto por essas declarações "using" identifica todos os arquivos que exigem atenção antes da tentativa de compilação.