Construya un SDK de código de barras en C#: Genere, lea y escanee códigos de barras con una sola biblioteca

¿Qué debe manejar un SDK de código de barras en proyectos .NET?

Un SDK de escáner de códigos de barras capaz necesita cubrir tres operaciones esenciales: generar códigos de barras, leer datos de códigos de barras de imágenes y documentos, y manejar problemas de calidad de escaneo del mundo real. Las mejores opciones de SDK de lector de códigos de barras también admiten una amplia gama de simbologías sin requerir bibliotecas separadas para cada una.

IronBarcode admite tanto códigos de barras lineales (Code 128, Code 39, UPC-A, UPC-E, EAN-8, EAN-13, GS1 DataBar) como códigos de barras 2D (Código QR, Data Matrix, PDF417, Aztec, MaxiCode). Esta cobertura significa que los desarrolladores .NET pueden procesar todo, desde etiquetas UPC-A de retail hasta códigos QR de almacén usando un único DLL de código de barras, sin dependencias adicionales, sin binarios nativos específicos de la plataforma. Una licencia de prueba gratuita da acceso completo a todas las características durante 30 días.

La biblioteca se ejecuta en sistemas operativos Windows, macOS y Linux, con soporte para implementaciones de aplicaciones .NET MAUI y Android. También se integra con herramientas de informes como Crystal Reports para escenarios que requieren generación de códigos de barras incrustada dentro de documentos empresariales. Ya sea que el proyecto sea una aplicación de consola, un escáner móvil .NET MAUI, o un lector de códigos de barras del lado del servidor procesando miles de imágenes, la misma API de SDK de escáner de códigos de barras lo maneja todo.

How Can Developers Generate Barcode Images in C#?

El método BarcodeWriter.CreateBarcode genera una imagen de código de barras a partir de un valor de cadena y una simbología especificada en una sola llamada. El objeto GeneratedBarcode devuelto puede guardarse como un archivo PNG, BMP, JPEG, PDF, HTML, o exportarse en formatos vectoriales como SVG.

using IronBarCode;
// Generate a Code 128 barcode image from string data
var barcode = BarcodeWriter.CreateBarcode("PKG-2025-88421", BarcodeEncoding.Code128);
barcode.AddAnnotationTextAboveBarcode("Shipping Label");
barcode.AddBarcodeValueTextBelowBarcode();
barcode.ResizeTo(500, 150);
barcode.SaveAsPng("shipping-label.png");
// Create a styled QR code with a logo
var qrCode = QRCodeWriter.CreateQrCode("https://example.com/track/88421", 300);
qrCode.ChangeBarCodeColor(IronSoftware.Drawing.Color.DarkSlateGray);
qrCode.SaveAsPng("tracking-qr.png");

using IronBarCode;
// Generate a Code 128 barcode image from string data
var barcode = BarcodeWriter.CreateBarcode("PKG-2025-88421", BarcodeEncoding.Code128);
barcode.AddAnnotationTextAboveBarcode("Shipping Label");
barcode.AddBarcodeValueTextBelowBarcode();
barcode.ResizeTo(500, 150);
barcode.SaveAsPng("shipping-label.png");
// Create a styled QR code with a logo
var qrCode = QRCodeWriter.CreateQrCode("https://example.com/track/88421", 300);
qrCode.ChangeBarCodeColor(IronSoftware.Drawing.Color.DarkSlateGray);
qrCode.SaveAsPng("tracking-qr.png");

¿Cómo funciona el lector de códigos de barras a través de archivos de imagen y PDF?

El método BarcodeReader.Read acepta una ruta de archivo de imagen, un arreglo de bytes, un bitmap o un flujo y devuelve una colección BarcodeResults que contiene cada código de barras encontrado en la entrada. Cada BarcodeResult expone el valor del código de barras, el tipo de codificación, el número de página, los datos binarios y la región de la imagen del código de barras.

using IronBarCode;
// Use the barcode reader to decode all barcodes from an image file
var results = BarcodeReader.Read("multiple-barcodes.png");
foreach (var result in results)
{
    Console.WriteLine($"Type: {result.BarcodeType} | Value: {result.Value}");
}
// The barcode reader also scans multi-page PDF documents
var pdfResults = BarcodeReader.ReadPdf("invoice-batch.pdf");
foreach (var item in pdfResults)
{
    Console.WriteLine($"Page {item.PageNumber}: {item.Value}");
}

using IronBarCode;
// Use the barcode reader to decode all barcodes from an image file
var results = BarcodeReader.Read("multiple-barcodes.png");
foreach (var result in results)
{
    Console.WriteLine($"Type: {result.BarcodeType} | Value: {result.Value}");
}
// The barcode reader also scans multi-page PDF documents
var pdfResults = BarcodeReader.ReadPdf("invoice-batch.pdf");
foreach (var item in pdfResults)
{
    Console.WriteLine($"Page {item.PageNumber}: {item.Value}");
}

¿Cómo puede un SDK de escáner de códigos de barras manejar la calidad de imagen del mundo real?

Las imágenes de códigos de barras del mundo real, de cámaras de almacén, capturas móviles o documentos escaneados, rara vez son perfectas en píxeles. La clase BarcodeReaderOptions proporciona un control granular sobre la velocidad de escaneo, las simbologías esperadas, los filtros de corrección de imagen y el procesamiento por lotes multihilo para lograr reconocimiento de códigos de barras altamente preciso incluso en entradas dañadas o desalineadas.

using IronBarCode;
// Configure the barcode reader for challenging, real-world image quality
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Detailed,
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional | BarcodeEncoding.QRCode,
    Multithreaded = true,
    MaxParallelThreads = 4,
    ImageFilters = new ImageFilterCollection
    {
        new SharpenFilter(),
        new ContrastFilter()
    }
};
// Scan multiple barcodes from a noisy image with high accuracy
var results = BarcodeReader.Read("camera-capture.jpg", options);
foreach (var barcode in results)
{
    Console.WriteLine($"Detected: {barcode.BarcodeType} — {barcode.Value}");
}

using IronBarCode;
// Configure the barcode reader for challenging, real-world image quality
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Detailed,
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional | BarcodeEncoding.QRCode,
    Multithreaded = true,
    MaxParallelThreads = 4,
    ImageFilters = new ImageFilterCollection
    {
        new SharpenFilter(),
        new ContrastFilter()
    }
};
// Scan multiple barcodes from a noisy image with high accuracy
var results = BarcodeReader.Read("camera-capture.jpg", options);
foreach (var barcode in results)
{
    Console.WriteLine($"Detected: {barcode.BarcodeType} — {barcode.Value}");
}

¿Qué tipos de códigos de barras y plataformas están soportados?

IronBarcode cubre las simbologías de códigos de barras más utilizadas en aplicaciones de retail, logística, salud y empresa. La siguiente tabla resume los tipos de códigos de barras soportados y las plataformas de destino.

La biblioteca se instala como un único paquete NuGet (BarCode) o como un DLL de código de barras independiente mediante descarga directa. No se requieren dependencias de SDK nativos, todo el SDK de escáner de códigos de barras se distribuye como código .NET gestionado. Instálalo en Visual Studio a través del Administrador de Paquetes NuGet, o ejecuta dotnet add package BarCode desde la CLI. Para escenarios de implementación que requieren control a nivel de DLL, la descarga de DLL de IronBarcode proporciona un paquete ZIP listo para integración manual.

IronBarcode también soporta la integración con Crystal Reports y otras herramientas de informes donde se necesita generación de códigos de barras incrustada. Para el desarrollo de aplicaciones .NET MAUI y Android, el SDK de escáner de códigos de barras proporciona lectura de códigos de barras multiplataforma sin requerir SDK específicos de cámara para la plataforma — simplemente pasa un archivo de imagen capturado por la cámara del dispositivo al lector de códigos de barras. El tutorial de escáner de códigos de barras .NET MAUI cubre este flujo de trabajo de .NET MAUI en detalle, incluidas las permisos de Android y un código de muestra para el escaneo móvil.

¿Dónde ir a partir de aquí?

IronBarcode ofrece a los desarrolladores .NET una biblioteca completa de códigos de barras para proyectos a nivel de SDK con generación, lectura, escaneo por lotes y exportación todo incluido, sin la complejidad de manejar múltiples paquetes. La última versión agrega preprocesamiento de imágenes impulsado por ML y el método ReadPdfs para procesamiento por lotes de PDF, continuando con lo que una sola biblioteca puede hacer.

Comience una prueba gratuita para probar cada característica en su propio proyecto sin marcas de agua ni restricciones. Cuando estés listo para la producción, explora las opciones de licencia de IronBarcode comenzando en $799 para desarrolladores individuales — con soporte gratuito incluido del equipo de ingeniería de Iron Software.

Empiece con IronBarcode ahora.

Comience gratis