¿Qué biblioteca de códigos de barras C# debería utilizar para el desarrollo .NET ?

El modelo de lectura "Format-First"

La API de lectura de Aspose.BarCode se basa en el supuesto de que el usuario conoce el formato del 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

Cuando se conoce el formato, este patrón funciona bien. El problema es "cuando se conoce el formato". Un sistema de compras que procesa facturas de proveedores no puede garantizar que todos los proveedores utilicen el mismo tipo de BarCode. Un sistema de gestión de documentos que acepta archivos subidos por los usuarios no puede predecir qué formato ha utilizado un escáner. En esos casos, DecodeType.AllSupportedTypes es la opción de reserva, y es típicamente más lenta que una lista dirigida de tipos de decodificación.

El decodificador también debe estar disponible:

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

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

No usar using es una fuga de recursos. El BarcodeGenerator también implementa IDisposable, aunque las consecuencias de no disponerlo son menos severas. En ambos casos, estás gestionando los ciclos de vida de los objetos que una API de fábrica estática manejaría automáticamente.

Comparación detallada de características

Enfoque de código de barras de Aspose.

Aspose.BarCode usa una clase BarcodeGenerator con una jerarquía Parameters para configuración. Una llamada de generación mínima requiere tres pasos: instanciación, llamada de guardado y especificación de formato. El uso real típicamente requiere navegar dentro de 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 personalización navega dentro de generator.Parameters.Barcode.*, que es una jerarquía de objetos multinivel. No es complejo una vez que lo has memorizado, pero requiere memorización.

Enfoque IronBarcode

IronBarcode reemplaza la jerarquía de parámetros con una cadena de métodos fluida. La configuración predeterminada produce resultados correctos para la mayoría de los casos de uso, y la personalización se expresa en línea:

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 los códigos QR, la API de generación de QR de IronBarcode incluye soporte para logotipos de marca sin necesidad de composición manual de imágenes:

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 no incluye un asistente de un solo llamado de logo de marca para códigos QR; el enfoque documentado es generar la imagen del código de barras y luego superponer el logotipo sobre ella (por ejemplo, con System.Drawing.Graphics). El AddBrandLogo de IronBarcode maneja la composición en una llamada y ajusta automáticamente la corrección de errores de manera apropiada.

Enfoque de código de barras de Aspose.

Aspose.BarCode no tiene soporte nativo para PDF. Para leer un código de barras de un PDF con Aspose, necesita Aspose.PDF para cargar el PDF y convertir las páginas en imágenes, y Aspose.BarCode para escanear esas imágenes generadas. Ambos son productos de suscripción. Ambos requieren activación de licencia. Está pagando dos suscripciones anuales por lo que la mayoría de los desarrolladores piensan como una sola capacidad.

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

Eso son dos configuraciones de licencia, dos declaraciones using de dos namespaces, una tubería de renderizado, gestión de memoria de flujos, y un bucle anidado. También usa DecodeType.AllSupportedTypes porque en el punto de extracción de imagen típicamente no se sabe qué formato usa el código de barras.

Enfoque IronBarcode

IronBarcode se encarga internamente del análisis de archivos PDF, la representación de páginas y la detección de códigos de barras. Llamas a Read con una ruta que termina en .pdf, y devuelve resultados de códigos de barras que incluyen result.PageNumber, así sabes de qué página proviene cada uno. Sin segundo paquete, sin segunda licencia, sin código de renderizado.

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

La documentación de IronBarcode sobre la lectura de archivos PDF abarca el procesamiento por lotes de varias páginas y las opciones de filtrado por rango de páginas.

Enfoque de código de barras de Aspose.

DecodeType.AllSupportedTypes es la solución de Aspose para escenarios de formato desconocido. La propia documentación de Aspose reconoce que es más lento que especificar una lista de destino, porque el decodificador recorre secuencialmente todas las simbologías conocidas. Para el procesamiento de alto volumen —un almacén que escanea miles de etiquetas por minuto— esta diferencia de rendimiento no es insignificante.

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

Enfoque IronBarcode

No existe un "modo lento" ni un "modo rápido" basados ​​en el conocimiento del formato. El sistema de detección de IronBarcode utiliza el mismo algoritmo tanto si la imagen contiene un código 128 como un DataMatrix. Si quieres ajustar los compromisos de rendimiento frente a precisión, la opción ReadingSpeed lo hace sin requerir conocimiento del 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 el rendimiento. ReadingSpeed.Detailed prioriza la precisión en imágenes dañadas o de bajo contraste. Ninguna de las dos opciones requiere que conozcas el formato de antemano. Consulte las opciones de lectura de IronBarcode para obtener el conjunto completo de parámetros de ajuste.

Llega la renovación de la suscripción.

La renovación anual de la suscripción es el momento en que los equipos suelen reconsiderar las decisiones relativas a la biblioteca. Si Aspose.BarCode es el único producto Aspose en la pila, pagar $999/año por desarrollador (o $4,995/año en el nivel Site) por funcionalidad de código de barras provoca una comparación. La conversación suele ser: "Vamos a pagar esto todos los años para siempre". ¿Cuánto cuesta IronBarcode una sola vez? En el nivel Professional (2999 dólares para 10 desarrolladores), IronBarcode se amortiza en el primer año con la licencia del Sitio.

Para equipos que utilizan Aspose.Total — donde Aspose.BarCode se incluye con muchos otros productos Aspose — la historia es diferente. El coste marginal de Aspose.BarCode dentro de ese paquete se aproxima a cero. Esos equipos tienen menos motivos para cambiar.

La compatibilidad con PDF se convierte en un requisito.

Muchos proyectos comienzan con la lectura de códigos de barras a partir de imágenes, y posteriormente añaden compatibilidad con PDF cuando alguna de las partes interesadas se da cuenta de que los documentos entrantes son archivos PDF en lugar de archivos de imagen. En ese momento, el equipo de Aspose.BarCode se enfrenta a una decisión: añadir Aspose.PDF (otra suscripción), buscar un generador de PDF de terceros o reevaluar la biblioteca de códigos de barras.

Agregar Aspose.PDF resuelve el requerimiento inmediato pero implica una segunda suscripción anual. Encontrar un renderizador de terceros agrega una dependencia y un esfuerzo de integración. Reevaluar la biblioteca de códigos de barras y descubrir que IronBarcode lee archivos PDF de forma nativa por una tarifa única suele ser el resultado.

Escenarios de formato desconocido en la producción

Las aplicaciones de cara al cliente que aceptan la carga de documentos no pueden controlar el formato de código de barras que utiliza el documento cargado. Si la aplicación fue construida suponiendo entradas de Code 128 y un cliente carga una etiqueta DataMatrix, un DecodeType.Code128 codificado devolverá silenciosamente sin resultados. Cambiar a DecodeType.AllSupportedTypes corrige la exactitud pero introduce un costo de rendimiento.

Los equipos que se han enfrentado a este problema —agregando más y más valores DecodeType a su configuración de lector a medida que nuevos formatos aparecen en producción— a menudo terminan manteniendo una lista que necesita actualizarse cada vez que se agrega una nueva fuente de formato. La detección automática de IronBarcode hace que esa lista sea innecesaria.

Implementaciones en la nube y en contenedores

La licencia basada en archivos de Aspose.BarCode añade un paso de implementación: el archivo de licencia debe ser accesible en tiempo de ejecución desde una ruta que la aplicación pueda leer. En un flujo de trabajo GitOps, el archivo de licencia acaba en el control de código fuente (lo que supone un riesgo de seguridad) o debe insertarse a través de un volumen secreto montado. El enfoque basado en claves de IronBarcode encaja perfectamente en los secretos de Kubernetes y las variables secretas de CI/CD, sin necesidad de gestionar ningún archivo en la imagen del contenedor.

Asignación de nombres de propiedades

El error de compilación más común después de cambiar de paquete es el renombramiento de result.CodeText a result.Value. Una búsqueda en todo el código lo cubre rápidamente:

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

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

result.CodeText se convierte en result.Value. result.CodeTypeName se convierte en result.Format.ToString(). La propiedad result.Format es un valor enum BarcodeEncoding, que también permite comparaciones tipificadas donde sea necesario.

Eliminación de DecodeType

Cada referencia DecodeType.* en la base de código puede ser eliminada:

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

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

Si se enumeró un DecodeType específico para mejorar el rendimiento en un formato conocido, ReadingSpeed.Faster en BarcodeReaderOptions proporciona un beneficio similar sin requerir conocimiento del formato.

Cambio en la inicialización de la licencia

Aspose.BarCode usa un archivo .lic cargado a través de license.SetLicense(). IronBarcode utiliza una clave de cadena:

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

Remove el archivo .lic del repositorio y los artefactos de construcción. En Docker, quita la línea COPY Aspose.BarCode.lic y reemplaza con una entrada ENV IRONBARCODE_LICENSE.

Correspondencia entre tipos de codificación y codificación de códigos de barras

EncodeTypes.QR se asocia con BarcodeEncoding.QRCode — la diferencia de nombres es donde los equipos más a menudo encuentran el primer error de compilación después de migrar código de generación. La mayoría de los mapeos son equivalentes directos con nombres consistentes.