Aspose.BarCode for .NET frente a IronBarcode: Comparación de bibliotecas de códigos de barras C#

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:

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

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 alternativa, y es significativamente más lenta que una lista de tipos de decodificación específica.

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 utilizar using supone una fuga de recursos. El BarcodeGenerator también implementa el IDisposable, aunque las consecuencias de no disponerlo son menos graves. 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 utiliza una clase BarcodeGenerator con una jerarquía Parameters para la 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 suele requerir navegar por 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 en generator.Parameters.Barcode.*, que es una jerarquía de objetos de varios niveles. 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 requiere el dibujo manual de GDI+ para superponer un logotipo en un código QR: generar la imagen del código de barras y, a continuación, utilizar System.Drawing.Graphics para componer el logotipo centrado sobre ella. El AddBrandLogo de IronBarcode se encarga de ello en una sola llamada y establece automáticamente la corrección de errores adecuada.

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. En conjunto, estaríamos hablando de entre 1.998 y 9.990 dólares al año por lo que la mayoría de los desarrolladores consideran una sola funcionalidad.

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

Se trata de dos configuraciones de licencia, dos sentencias using de dos namespaces, un pipeline de renderizado, gestión de flujos de memoria y un bucle anidado. También utiliza DecodeType.AllSupportedTypes porque en el punto de extracción de la imagen normalmente no se sabe qué formato utiliza 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. Se llama a Read con una ruta que termina en .pdf, y devuelve resultados de código de barras que incluyen result.PageNumberpara que sepa 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 situaciones 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;

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

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 desea ajustar las compensaciones entre rendimiento y precisión, la opción ReadingSpeed lo hace sin necesidad de conocer el 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 de Aspose en la pila, un precio de entre 999 y 4995 dólares al año por la funcionalidad de códigos de barras invita a realizar 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 los equipos que utilizan Aspose.Total —donde Aspose.BarCode viene incluido con más de 20 productos— los cálculos son diferentes. 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 problema inmediato, pero duplica el costo de la suscripción. Buscar un motor de renderizado de terceros añade 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 se construyó asumiendo entradas de Código 128 y un cliente carga una etiqueta DataMatrix, un DecodeType.Code128 codificado no devolverá ningún resultado. El cambio a DecodeType.AllSupportedTypes arregla la corrección pero introduce un coste de rendimiento.

Los equipos que se han encontrado con este problema -añadir más y más valores DecodeType a su configuración de lector a medida que aparecen nuevos formatos en producción- a menudo acaban manteniendo una lista que necesita actualizarse cada vez que se añade 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 intercambiar paquetes es el cambio de nombre de result.CodeTexta 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.CodeTypeNamese convierte en result.Format.ToString(). La propiedad result.Format es un valor enum BarcodeEncoding, que también permite comparaciones tipográficas cuando sea necesario.

Eliminación de DecodeType

Se pueden eliminar todas las referencias DecodeType.* del código base:

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

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

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

Cambio en la inicialización de la licencia

Aspose.BarCode utiliza 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"))

Eliminar el archivo .lic del repositorio y construir artefactos. En Docker, elimine la línea COPY Aspose.BarCode.lic y sustitúyala por una entrada ENV IRONBARCODE_LICENSE.

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

EncodeTypes.QR se corresponde con BarcodeEncoding.QRCode - la diferencia de nomenclatura es donde los equipos se encuentran más a menudo con el primer error de compilación después de migrar el código de generación. El resto de correspondencias son equivalencias directas con una nomenclatura coherente.