NetBarcode vs IronBarcode: Comparación de bibliotecas de códigos de barras C#

El límite de diseño de enumeración de tipos

El Type enum es la lista autorizada de lo que Código de barras de red puede generar. Al inspeccionarla se revela el alcance de la biblioteca:

// Código de barras de red 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

// Código de barras de red 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

' Código de barras de red 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
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

No se trata de una función faltante pendiente de una solicitud de incorporación de cambios. La enumeración tiene catorce entradas, todas unidimensionales, lo que refleja el alcance previsto de la biblioteca. Cualquier aplicación que requiera códigos QR, DataMatrix, PDF417o azteca deberá adquirir un paquete aparte para proporcionar dichos formatos.

Comparación detallada de características

Enfoque de NetBarcode

NetBarcode proporciona 14 formatos de códigos de barras lineales a través del enum Type. Dentro de ese ámbito, la selección del formato es sencilla: basta con pasar el miembro de enumeración apropiado al constructor. El límite es igualmente claro: intentar utilizar un formato fuera de la enumeración produce un error de compilación.

// Código de barras de red — 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");

// Código de barras de red — 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

// Código de barras de red — 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");

// Código de barras de red — 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")

' Código de barras de red — 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

Entre los sectores donde este límite se convierte en una restricción se incluyen el seguimiento farmacéutico (DataMatrix es obligatorio según las normativas de códigos de barras 2D de la FDA), las tarjetas de embarque aéreas (Aztec), los manifiestos logísticos (PDF417) y el marketing móvil (código QR). Cada uno de estos requisitos descarta a Código de barras de red como solución independiente.

Enfoque IronBarcode

IronBarcode expone todos los formatos compatibles a través del mismo método BarcodeWriter.CreateBarcode. La superficie de la API no cambia al pasar de un formato 1D a un formato 2D - sólo difiere la constante BarcodeEncoding.

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

La lista completa de constantes compatibles está disponible en la referencia de formatos de código de barras compatibles , que abarca todos los formatos de generación de códigos de barras 2D junto con el conjunto completo de 1D.

Enfoque de NetBarcode

El modelo de generación de Código de barras de red se basa en un constructor. Un objeto Barcode es instanciado con la cadena de datos y un valor Type enum. El resultado se guarda directamente con SaveImageFile() o se recupera como Image<Rgba32> a través de GetImage(). Desde la versión 1.8, el tipo de retorno de GetImage() es el tipo SixLabors.ImageSharp, lo que significa que cualquier código que almacene o procese el valor de retorno debe importar y trabajar dentro de la 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

El tipo de retorno del método GetImage() vincula el código descendente a la biblioteca ImageSharp. Cualquier método que acepte o almacene el resultado debe declararlo como Image<Rgba32>, introduciendo una dependencia transitiva en el código de llamada.

Enfoque IronBarcode

IronBarcode utiliza una cadena fluida. BarcodeWriter.CreateBarcode devuelve un objeto GeneratedBarcode que contiene múltiples métodos de salida. El procesamiento de imágenes es interno; ningún tipo ImageSharp se expone al código que realiza la llamada.

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

En la documentación de IronBarcode se describen las opciones detalladas para la generación de códigos de barras 1D, incluyendo el ancho, la altura y la configuración de la etiqueta.

Enfoque de NetBarcode

NetBarcode no tiene API de lectura. No existe ningún método, clase o configuración que decodifique una imagen de código de barras para convertirla de nuevo en su cadena de datos. Se trata de una delimitación deliberada del alcance, no de una omisión pendiente de publicación. Un proyecto que genera códigos de barras con Código de barras de red y posteriormente necesita leerlos —para validar una etiqueta impresa, escanear un envío de devolución o extraer valores de una factura de proveedor— debe introducir una biblioteca independiente para ese fin.

// Código de barras de red — 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

// Código de barras de red — 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

' Código de barras de red — 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

La biblioteca ZXing .NET es la adición más común para la lectura junto con NetBarcode, ya que aporta una tercera interfaz API y un tercer paquete para la gestión de versiones, además de Código de barras de red y cualquier biblioteca 2D ya añadida para códigos QR.

Enfoque IronBarcode

IronBarcode incluye BarcodeReader en el mismo paquete que BarcodeWriter. La API de lectura acepta archivos de imagen y documentos PDF, y devuelve una colección de resultados decodificados, cada uno con el valor del código de barras, el tipo de formato y el número de página si la lectura se realiza desde un 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

La guía para leer códigos de barras a partir de imágenes abarca opciones como el ajuste de velocidad, la detección de múltiples códigos de barras y la corrección de imágenes disponibles en la API de lectura.

Código de barras de red e ImageSharp

NetBarcode tiene licencia MIT. La biblioteca SixLabors.ImageSharp de la que depende utiliza un modelo diferente: es gratuita para proyectos de código abierto y para empresas con ingresos brutos anuales inferiores a un umbral definido, pero se requiere una licencia comercial por encima de ese umbral. Esta división se aplica independientemente de si ImageSharp aparece explícitamente en el .csproj de un proyecto o llega de forma transitoria a través de NetBarcode.

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

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

Para una empresa minorista o de logística que procesa códigos de barras a gran escala, el principal caso de uso al que se dirige NetBarcode, los ingresos anuales suelen estar por encima del umbral a partir del cual se aplica la licencia comercial de ImageSharp. Una auditoría de cumplimiento puede revelar esta obligación integrada en el árbol de paquetes.

La versión v1.8 introdujo una consecuencia adicional de la dependencia de ImageSharp: el tipo de retorno de GetImage() cambió de una representación interna a SixLabors.ImageSharp.Image<Rgba32>. El código existente que llamaba a GetImage() sin tipado explícito se rompía en tiempo de compilación, y se requerían nuevas directivas using para SixLabors.ImageSharp y SixLabors.ImageSharp.PixelFormats. Cuando la API de ImageSharp evolucione en futuras versiones, la API pública de Código de barras de red se verá afectada a su vez.

Código de barras de hierro

IronBarcode no tiene ninguna dependencia de SixLabors.ImageSharp. Sus condiciones de licencia se establecen directamente en la página de licencias de IronBarcode , sin umbral mínimo ni obligación comercial transitiva. Hay disponible una clave de prueba para su evaluación; Las licencias adquiridas eliminan la marca de agua de la versión de prueba de los resultados generados.

Requisitos de código QR y formato 2D

El motivo más frecuente para evaluar una alternativa a Código de barras de red es un nuevo requisito para los códigos QR. Las aplicaciones que comienzan con la generación de códigos de barras 1D para etiquetas de venta minorista o manifiestos de envío suelen recibir un requisito posterior para códigos QR: enlaces sin contacto, enlaces directos a aplicaciones móviles, campañas de marketing. Dado que el enum Type no tiene entrada QR, este requisito no puede cumplirse con NetBarcode. Los equipos que añaden una biblioteca de códigos QR independiente para solucionar esta deficiencia se enfrentan a una segunda evaluación cuando se requiere Matriz de datos para una integración farmacéutica, o PDF417para un transportista logístico que lo exige en las etiquetas de envío.

La lectura de códigos de barras se vuelve necesaria.

Algunos proyectos comienzan con la generación pura y posteriormente añaden un requisito de validación o procesamiento de documentos: confirmar que un código de barras impreso coincide con sus datos de origen, extraer valores de códigos de barras de las facturas de proveedores entrantes o escanear etiquetas de envío de devolución. Código de barras de red no proporciona ninguna ruta para esto. La incorporación de ZXing .NET o una biblioteca de lectura comparable introduce una tercera API que aprender y mantener en el mismo código base que ya contiene Código de barras de red y una biblioteca QR. Los proyectos que prevén necesidades de lectura, incluso en una fase futura, suelen encontrar más eficiente seleccionar una biblioteca que satisfaga ambas necesidades desde el principio.

Auditoría de licencias comerciales de ImageSharp

En ocasiones, las revisiones legales y de cumplimiento de las dependencias de terceros sacan a la luz la condición de licencia comercial de SixLabors.ImageSharp integrada en el árbol de paquetes de NetBarcode. Para las empresas cuyos ingresos brutos anuales superen el umbral, la obligación se aplica tanto si ImageSharp se seleccionó deliberadamente como si se obtuvo de forma indirecta a través de NetBarcode. Los equipos que descubren esto durante una auditoría, en lugar de antes de la adopción, se enfrentan a una corrección retroactiva en lugar de una migración planificada. Evaluar la licencia de dependencia antes de comenzar un proyecto es la opción más limpia.

Reducción de la complejidad de múltiples bibliotecas

Los equipos que han acumulado Código de barras de red para la generación 1D, una biblioteca específica para códigos QR para la salida 2D y ZXing .NET para la lectura, se encuentran con la necesidad de mantener la compatibilidad de versiones en tres paquetes diferentes. Cada ciclo de actualización requiere comprobar si las tres bibliotecas coinciden en su versión compartida de ImageSharp. Cada nuevo desarrollador del proyecto se encuentra con tres API diferentes para lo que conceptualmente es una sola cuestión. La consolidación en una única biblioteca de códigos de barras simplifica la incorporación de nuevos usuarios, reduce la superficie de conflicto de versiones y concentra el mantenimiento en un único ciclo de lanzamiento.

Intercambio de paquetes y limpieza de dependencias transitivas

La eliminación de Código de barras de red con dotnet remove package NetBarcode es el primer paso. El paquete SixLabors.ImageSharp puede reaparecer en el árbol de dependencias si otros paquetes en el proyecto también tiran de él de forma transitoria. Tras la eliminación, inspeccione la lista de paquetes restaurada con dotnet list package --include-transitive para confirmar si ImageSharp sigue presente y si su condición de licencia comercial sigue siendo aplicable.

Sustitución del tipo de retorno de GetImage()

Cualquier código que almacene el resultado de GetImage() como Image<Rgba32> debe ser actualizado. El tipo ImageSharp no tiene un equivalente directo en IronBarcode; La sustitución depende de cómo se haya utilizado la imagen posteriormente. El código que guardaba la imagen en un flujo puede sustituirse por .SaveAsPng(stream) directamente en el objeto GeneratedBarcode. El código que recupera bytes sin procesar puede usar .ToPngBinaryData(). El código que realice manipulaciones adicionales de ImageSharp en la imagen devuelta requerirá que esas operaciones se evalúen individualmente.

Actualización del espacio de nombres

Los archivos que importaron using NetBarcode;, using SixLabors.ImageSharp;, using SixLabors.ImageSharp.PixelFormats;, o using SixLabors.Fonts; necesitan que esas directivas sean reemplazadas por using IronBarCode;. Una búsqueda en todo el proyecto de estas declaraciones using identifica todos los archivos que requieren atención antes de intentar la compilación.