El requisito de especificación de tipo

El BarcodeScanner.Scan() de Spire.Barcode no tiene sobrecarga que acepte solo una ruta de archivo. Cada operación de lectura exige que el código que la realiza declare el formato del código de barras con antelación. Para flujos de trabajo de formato único esto funciona, pero para el procesamiento de documentos de formato mixto produce un bucle de iteración candidato:

// Spire.Barcode: multi-format detection iterates through candidate types
BarcodeScanner scanner = new BarcodeScanner();
var candidates = new[] { BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417 };

string foundValue = null;
foreach (var type in candidates)
{
    string[] found = scanner.Scan("barcode.png", type);
    if (found.Length > 0)
    {
        foundValue = found[0];
        break;
    }
}

// Spire.Barcode: multi-format detection iterates through candidate types
BarcodeScanner scanner = new BarcodeScanner();
var candidates = new[] { BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417 };

string foundValue = null;
foreach (var type in candidates)
{
    string[] found = scanner.Scan("barcode.png", type);
    if (found.Length > 0)
    {
        foundValue = found[0];
        break;
    }
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim candidates = {BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417}

Dim foundValue As String = Nothing
For Each type In candidates
    Dim found As String() = scanner.Scan("barcode.png", type)
    If found.Length > 0 Then
        foundValue = found(0)
        Exit For
    End If
Next

Cada tipo que se agrega al array de candidatos supone una pasada de escaneo adicional. Cualquier formato que falte en la lista se omite silenciosamente. El desarrollador es responsable de mantener un inventario exhaustivo de tipos y de volver a realizar pruebas cada vez que se incorpore un nuevo formato al flujo de trabajo.

Comparación detallada de características

Spire. Enfoque de código de barras

El BarcodeScanner.Scan() de Spire.Barcode requiere un parámetro BarCodeType en cada llamada. La llamada de un solo tipo es apropiada cuando el formato es conocido y está garantizado:

// Spire.Barcode — type is mandatory
BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("barcode.png", BarCodeType.Code128);

foreach (string value in results)
{
    Console.WriteLine(value);
}

// Spire.Barcode — type is mandatory
BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("barcode.png", BarCodeType.Code128);

foreach (string value in results)
{
    Console.WriteLine(value);
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim results As String() = scanner.Scan("barcode.png", BarCodeType.Code128)

For Each value As String In results
    Console.WriteLine(value)
Next

Cuando el formato no se conoce de antemano, el único método disponible es iterar a través de los tipos candidatos. Cada iteración consiste en un escaneo completo, y cualquier formato que no esté en la lista se omite silenciosamente. El resultado es un string[] que no lleva información de tipo, por lo que el enrutamiento posterior basado en el formato requiere una gestión adicional del estado por parte del llamador.

Enfoque IronBarcode

El BarcodeReader.Read() de IronBarcode no requiere un parámetro de tipo. La biblioteca detecta automáticamente el formato en todas las simbologías compatibles en una sola pasada. La lectura de códigos de barras a partir de imágenes se realiza mediante una única llamada a un método, independientemente de la cantidad de formatos diferentes que pueda contener la fuente:

// IronBarcode: automatic format detection
var results = BarcodeReader.Read("barcode.png");

foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

// IronBarcode: automatic format detection
var results = BarcodeReader.Read("barcode.png");

foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

Imports IronBarCode

' IronBarcode: automatic format detection
Dim results = BarcodeReader.Read("barcode.png")

For Each result In results
    Console.WriteLine($"{result.Format}: {result.Value}")
Next

Cada objeto de resultado incluye Format, Value y metadatos posicionales. El enrutamiento descendente basado en el formato no requiere ningún estado adicional; el tipo está presente en el propio resultado.

Spire.Barcode Nivel gratuito

FreeSpire.Barcode aplica una marca de agua de evaluación grande a las imágenes de códigos de barras generadas. La marca de agua cubre el código de barras de tal manera que lo hace inadecuado para su uso en producción y dificulta una evaluación significativa de la calidad de generación. En la versión gratuita, el rendimiento del escaneo se ve intencionadamente reducido, lo que significa que las mediciones de rendimiento realizadas durante la evaluación no representan el rendimiento de la versión comercial de Spire.Barcode. El paquete gratuito también requiere una clave de registro obtenida de E-iceblue para que se supriman los cuadros de diálogo de advertencia durante la ejecución. La simbología disponible en el nivel gratuito es un subconjunto de la oferta comercial. En conjunto, estas restricciones implican que una evaluación basada en FreeSpire.Barcode no representa con precisión lo que ofrece el producto comercial.

Modo de prueba de IronBarcode

La versión de prueba de IronBarcode es el paquete con licencia que se utiliza sin una clave de licencia. La lectura se realiza a máxima velocidad con soporte completo para la simbología y sin restricciones de comportamiento. Las opciones de velocidad y precisión de lectura funcionan de forma idéntica tanto en el modo de prueba como en el modo con licencia. El código de barras generado en modo de prueba incluye una pequeña marca de agua en el borde de la imagen; No oculta el código de barras en sí. El comportamiento que se mide durante una evaluación de IronBarcode es el comportamiento que se implementa en producción.

Spire. Enfoque de código de barras

Spire.Barcode no tiene capacidad nativa para leer archivos PDF. Para extraer códigos de barras de un archivo PDF, un desarrollador debe instalar el paquete Spire.PDF separado, comprar una licencia de Spire.PDF y escribir código manual de iteración de páginas y extracción de imágenes antes de que pueda comenzar el escaneo de códigos de barras:

// Spire.Barcode + Spire.PDF: separate package and license required
using Spire.Pdf;

var pdf = new PdfDocument();
pdf.LoadFromFile("document.pdf");

var scanner = new BarcodeScanner();
foreach (PdfPageBase page in pdf.Pages)
{
    var images = page.ExtractImages();
    foreach (var image in images)
    {
        // BarCodeType is still required for each scan call
        string[] results = scanner.Scan(image, BarCodeType.QRCode);
    }
}

// Spire.Barcode + Spire.PDF: separate package and license required
using Spire.Pdf;

var pdf = new PdfDocument();
pdf.LoadFromFile("document.pdf");

var scanner = new BarcodeScanner();
foreach (PdfPageBase page in pdf.Pages)
{
    var images = page.ExtractImages();
    foreach (var image in images)
    {
        // BarCodeType is still required for each scan call
        string[] results = scanner.Scan(image, BarCodeType.QRCode);
    }
}

Imports Spire.Pdf

Dim pdf As New PdfDocument()
pdf.LoadFromFile("document.pdf")

Dim scanner As New BarcodeScanner()
For Each page As PdfPageBase In pdf.Pages
    Dim images = page.ExtractImages()
    For Each image In images
        ' BarCodeType is still required for each scan call
        Dim results As String() = scanner.Scan(image, BarCodeType.QRCode)
    Next
Next

Este patrón requiere dos paquetes NuGet , dos acuerdos de licencia y código de gestión de páginas escrito por el desarrollador. Si los códigos de barras están incrustados en contenido vectorial en lugar de imágenes rasterizadas dentro del PDF, el método de extracción de imágenes podría no detectarlos por completo.

Enfoque IronBarcode

IronBarcode maneja archivos PDF de forma nativa sin ninguna dependencia adicional. Leer códigos de barras de documentos PDF es una única llamada de método usando la misma API BarcodeReader.Read() utilizada para archivos de imagen. Los números de página se incluyen en cada objeto de resultado:

// IronBarcode: native PDF reading from the same Read() method
var results = BarcodeReader.Read("document.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}");
}

// IronBarcode: native PDF reading from the same Read() method
var results = BarcodeReader.Read("document.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}");
}

Imports IronBarcode

' IronBarcode: native PDF reading from the same Read() method
Dim results = BarcodeReader.Read("document.pdf")

For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}")
Next

No se requiere extracción manual de páginas, ni paquete secundario, ni compra de licencias adicionales.

Spire. Enfoque de código de barras

El modelo de generación de Spire.Barcode se centra en un objeto de configuración BarcodeSettings mutable. Un desarrollador instancia la configuración, asigna propiedades individualmente, pasa el objeto de configuración a un BarCodeGenerator, y luego llama a GenerateImage():

// Spire.Barcode generation
using Spire.Barcode;

BarcodeSettings settings = new BarcodeSettings();
settings.Type = BarCodeType.Code128;
settings.Data = "12345678";
settings.ShowText = true;
settings.TextMargin = 5;
settings.BarHeight = 60;
settings.Unit = GraphicsUnit.Pixel;

BarCodeGenerator generator = new BarCodeGenerator(settings);
Image barcodeImage = generator.GenerateImage();
barcodeImage.Save("barcode.png", ImageFormat.Png);

// Spire.Barcode generation
using Spire.Barcode;

BarcodeSettings settings = new BarcodeSettings();
settings.Type = BarCodeType.Code128;
settings.Data = "12345678";
settings.ShowText = true;
settings.TextMargin = 5;
settings.BarHeight = 60;
settings.Unit = GraphicsUnit.Pixel;

BarCodeGenerator generator = new BarCodeGenerator(settings);
Image barcodeImage = generator.GenerateImage();
barcodeImage.Save("barcode.png", ImageFormat.Png);

Imports Spire.Barcode
Imports System.Drawing
Imports System.Drawing.Imaging

Dim settings As New BarcodeSettings()
settings.Type = BarCodeType.Code128
settings.Data = "12345678"
settings.ShowText = True
settings.TextMargin = 5
settings.BarHeight = 60
settings.Unit = GraphicsUnit.Pixel

Dim generator As New BarCodeGenerator(settings)
Dim barcodeImage As Image = generator.GenerateImage()
barcodeImage.Save("barcode.png", ImageFormat.Png)

El hecho de que el objeto de configuración sea mutable implica que las configuraciones pueden compartirse accidentalmente entre llamadas cuando se reutiliza una única instancia en múltiples operaciones de generación. La clase generadora añade un paso de instanciación adicional que no contiene lógica de configuración propia.

Enfoque IronBarcode

IronBarcode utiliza un método de fábrica estático con encadenamiento fluido opcional. No hay ningún objeto de configuración ni ninguna instancia de generador que gestionar:

// IronBarcode generation
using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

// IronBarcode generation
using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .SaveAsPng("barcode.png")

' With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("barcode.png")

Los códigos QR con logotipos personalizados están disponibles en todos los niveles de licencia de IronBarcode :

var qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-with-logo.png");

var qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-with-logo.png");

Dim qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
qr.AddBrandLogo("logo.png")
qr.SaveAsPng("qr-with-logo.png")

Procesamiento de documentos de formato mixto

Los equipos que comienzan con un único formato de código de barras conocido suelen descubrir que la diversidad de formatos aumenta con el tiempo. Una aplicación de almacenamiento que empezó con etiquetas Code128 puede recibir envíos de proveedores que utilizan DataMatrix, GS1-128 o códigos QR. Cada nuevo formato que entra en el flujo de trabajo requiere actualizar la matriz de candidatos en el bucle de adivinación de tipos, volver a probar la lógica de detección y confirmar que ningún formato existente se ve desplazado por el orden de iteración. Cuando la diversidad de formatos alcanza un punto en el que la sobrecarga de mantenimiento de ese bucle se convierte en un coste de desarrollo recurrente, los equipos evalúan si la detección automática eliminaría por completo esa carga.

Integración de PDF

Las aplicaciones que manejan gran cantidad de documentos a menudo se encuentran con un momento en el que deben extraer códigos de barras de archivos PDF en lugar de imágenes independientes. En un flujo de trabajo de Spire.Barcode, esta transición requiere adquirir una licencia de Spire.PDF, integrar un segundo paquete y desarrollar la infraestructura de iteración de páginas y extracción de imágenes antes de que se pueda realizar cualquier lectura de códigos de barras. Los equipos que no previeron este requisito al realizar la compra inicial se encuentran gestionando dos licencias de producto y dos interfaces API para una tarea que, conceptualmente, pertenece a la lectura de códigos de barras. Descubrir que la compatibilidad con archivos PDF requiere una compra aparte es un motivo frecuente para reevaluar la selección del producto.

Limitaciones de la evaluación del nivel gratuito

Los equipos que evaluaron FreeSpire.Barcode y luego adquirieron la licencia comercial a veces informan que el producto comercial se comporta de manera diferente a como lo indicaba su evaluación. Esto es intencional: el nivel gratuito degrada deliberadamente el rendimiento de lectura y restringe el conjunto de símbolos, lo que significa que las pruebas de rendimiento y de cobertura de formato realizadas durante la evaluación no se transfieren a la implementación comercial. Cuando un equipo descubre esta discrepancia después de la compra, suele buscar alternativas cuyo comportamiento en las pruebas sea representativo del comportamiento en producción.

Reducción del número de productos

Las organizaciones que estandarizan su conjunto de tecnologías a veces identifican Spire.Barcode como un componente más en un inventario creciente de productos E-iceblue, cada uno con su propio costo de licencia y ciclo de renovación. Si el principal objetivo de Spire.Barcode es la lectura de códigos de barras dentro de un proceso de gestión de documentos, en lugar de una integración profunda con Spire.Doc o Spire.XLS, los equipos evalúan si una única biblioteca de códigos de barras independiente reduciría tanto la complejidad de las licencias como la superficie de soporte.

Eliminación del parámetro BarCodeType

Cada llamada a scanner.Scan() en una base de código de Spire.Barcode lleva un argumento BarCodeType. Reemplazar estas llamadas con BarcodeReader.Read() elimina completamente el parámetro de tipo. Los bucles de adivinanza de tipos — bloques foreach que iteran a través de valores BarCodeType candidatos — pueden eliminarse por completo; una sola llamada a BarcodeReader.Read() reemplaza todo el bucle.

Actualización del tipo de retorno

El Scan() de Spire.Barcode devuelve string[]. IronBarcode devuelve una colección BarcodeResults. Los sitios de llamada que asignan a string[] o pasan los resultados a métodos que esperan ese tipo requieren una actualización. Extraer valores como un array usa .Select(r => r.Value).ToArray(); acceder al primer resultado usa .First()?.Value.

Eliminación del paquete Spire.PDF

Si Spire.PDF fue instalado únicamente para soportar la extracción de códigos de barras de archivos PDF, puede eliminarse después de migrar a IronBarcode. Todas las importaciones de using Spire.Pdf; y los bloques de iteración de página manuales son reemplazados por una sola llamada a BarcodeReader.Read("file.pdf"). Si Spire.PDF se utiliza para otras operaciones documentales más allá de la extracción de códigos de barras, debe conservarse y solo deben reemplazarse las rutas de código relacionadas con códigos de barras.

Cambios en el espacio de nombres

Reemplace using Spire.Barcode; con using IronBarCode;. El enum BarCodeType se reemplaza por BarcodeEncoding para generación y no requiere un equivalente para lectura. La inicialización de la licencia cambia de Spire.License.LicenseProvider.SetLicenseKey() a una sola asignación de propiedad IronBarCode.License.LicenseKey al iniciar la aplicación.