C# Barcode Scanner: Read Barcodes & QR Codes in .NET Applications

Q: ¿Cuál es el método para leer un código de barras desde una imagen usando C#?

Utilice el método BarcodeReader.Read de IronBarcode con una sola línea de código: var results = BarcodeReader.Read('image.png'); Este método detecta y lee todos los formatos de códigos de barras presentes en la imagen.

Q: ¿Cómo leo códigos de barras de un PDF usando C#?

Utilice el método BarcodeReader.ReadPdf de IronBarcode para escanear todas las páginas de un documento PDF: var results = BarcodeReader.ReadPdf('document.pdf'); Cada resultado incluye el número de página donde se encontró el código de barras.

Q: ¿Qué debo hacer si las imágenes de los códigos de barras están borrosas o rotadas?

Configure BarcodeReaderOptions para manejar imágenes desafiantes estableciendo AutoRotate = true y aplicando filtros de imagen como SharpenFilter o AdaptiveThresholdFilter . Utilice Speed = ExtremeDetail para mayor precisión.

Q: ¿Puedo extraer imágenes de códigos de barras después de que se escanean?

Sí, el BarcodeResult de IronBarcode incluye una propiedad BarcodeImage que contiene un Bitmap del código de barras detectado, que puede ser guardado o procesado por separado.

Q: ¿Cómo leo códigos de barras de páginas específicas dentro de un documento PDF?

Establezca la propiedad PageNumbers en BarcodeReaderOptions para especificar páginas: options.PageNumbers = new[] {1, 2, 3}; Esto optimiza el rendimiento al escanear solo las páginas designadas.

Jacob Mellor

Updated: 4 de junio de 2026

¿Necesitas escanear rápidamente códigos de barras o QR en tu aplicación .NET? IronBarcode hace que la lectura de códigos de barras sea sencilla y confiable, ya sea que estés procesando imágenes digitales perfectas o fotos desafiantes del mundo real. Esta guía te muestra exactamente cómo implementar el escaneo de códigos de barras en C# con ejemplos prácticos que puedes usar de inmediato.

Inicio rápido: Leer un código de barras desde un archivo instantáneamente

Este ejemplo rápido te muestra lo fácil que es comenzar con IronBarcode. En solo una línea de código, puedes leer códigos de barras de un archivo de imagen, sin necesidad de configuraciones complejas.

1Install IronBarcode with NuGet Package Manager
PM > Install-Package BarCode
```
Install-Package BarCode
```

2Copie y ejecute este fragmento de código.

var results = IronBarCode.BarcodeReader.Read("path/to/barcode.png");

var results = IronBarCode.BarcodeReader.Read("path/to/barcode.png");

3Despliegue para probar en su entorno real

Comienza a usar IronBarcode en tu proyecto hoy mismo con una prueba gratuita

Flujo de trabajo mínimo (5 pasos)

Instalar IronBarcode desde NuGet o mediante descarga de DLL
Utilice el método BarcodeReader.Read para escanear cualquier código de barras o código QR
Lea varios códigos de barras o códigos QR en un solo escaneo, PDF o archivo TIFF de varios fotogramas
Habilite IronBarcode para decodificar escaneos y fotografías imperfectas con filtros avanzados
Descargue el proyecto tutorial y comience a escanear inmediatamente

¿Cómo instalo IronBarcode en mi proyecto .NET?

IronBarcode se instala fácilmente a través del Administrador de Paquetes NuGet o descargando directamente la DLL. La instalación a través de NuGet es el enfoque recomendado, ya que gestiona automáticamente dependencias y actualizaciones.

PM > Install-Package BarCode

Install-Package BarCode

Después de la instalación, agrega using IronBarCode; a tus archivos C# para acceder a la funcionalidad de escaneo de códigos de barras. Para obtener instrucciones detalladas de instalación en diferentes entornos de desarrollo, consulta nuestra guía de instalación.

¿Cómo puedo leer mi primer código de barras usando C#?

Leer códigos de barras con IronBarcode requiere solo una línea de código. La biblioteca detecta automáticamente los formatos de código de barras y extrae todos los datos codificados.

Código de barras Code128 listo para escanear - contiene el texto 'https://ironsoftware.com/csharp/barcode/'

Un código de barras Code128 estándar que IronBarcode puede leer instantáneamente

using IronBarCode;

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection() {
        new AdaptiveThresholdFilter(),
    },

    // Uses machine learning to auto rotate the barcode
    AutoRotate = true,
};

// Read barcode
BarcodeResults results = BarcodeReader.Read("TryHarderQR.png", options);

using IronBarCode;

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection() {
        new AdaptiveThresholdFilter(),
    },

    // Uses machine learning to auto rotate the barcode
    AutoRotate = true,
};

// Read barcode
BarcodeResults results = BarcodeReader.Read("TryHarderQR.png", options);

Imports IronBarCode

Private options As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection() From {New AdaptiveThresholdFilter()},
	.AutoRotate = True
}

' Read barcode
Private results As BarcodeResults = BarcodeReader.Read("TryHarderQR.png", options)

Imports IronBarCode

Private options As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection() From {New AdaptiveThresholdFilter()},
	.AutoRotate = True
}

' Read barcode
Private results As BarcodeResults = BarcodeReader.Read("TryHarderQR.png", options)

El método BarcodeReader.Read devuelve una colección BarcodeResults que contiene todos los códigos de barras detectados. Cada BarcodeResult proporciona acceso al valor de texto del código de barras, tipo de formato, coordenadas de posición y datos binarios. Este enfoque funciona a la perfección con formatos comunes de códigos de barras, incluidos los códigos Code128, Code39, QR y Data Matrix.

¿Qué opciones ayudan a leer códigos de barras desafiantes o dañados?

El escaneo de códigos de barras en el mundo real a menudo involucra imágenes imperfectas: ángulos sesgados, mala iluminación o daños parciales. Las opciones avanzadas de IronBarcode manejan estos desafíos de manera efectiva.

using IronBarCode;
using System;

// Multiple barcodes may be scanned up from a single document or image. A PDF document may also used as the input image
BarcodeResults results = BarcodeReader.ReadPdf("MultipleBarcodes.pdf");

// Work with the results
foreach (var pageResult in results)
{
    string Value = pageResult.Value;
    int PageNum = pageResult.PageNumber;
    System.Drawing.Bitmap Img = pageResult.BarcodeImage;
    BarcodeEncoding BarcodeType = pageResult.BarcodeType;
    byte[] Binary = pageResult.BinaryValue;
    Console.WriteLine(pageResult.Value + " on page " + PageNum);
}

using IronBarCode;
using System;

// Multiple barcodes may be scanned up from a single document or image. A PDF document may also used as the input image
BarcodeResults results = BarcodeReader.ReadPdf("MultipleBarcodes.pdf");

// Work with the results
foreach (var pageResult in results)
{
    string Value = pageResult.Value;
    int PageNum = pageResult.PageNumber;
    System.Drawing.Bitmap Img = pageResult.BarcodeImage;
    BarcodeEncoding BarcodeType = pageResult.BarcodeType;
    byte[] Binary = pageResult.BinaryValue;
    Console.WriteLine(pageResult.Value + " on page " + PageNum);
}

Imports IronBarCode
Imports System

' Multiple barcodes may be scanned up from a single document or image. A PDF document may also used as the input image
Private results As BarcodeResults = BarcodeReader.ReadPdf("MultipleBarcodes.pdf")

' Work with the results
For Each pageResult In results
	Dim Value As String = pageResult.Value
	Dim PageNum As Integer = pageResult.PageNumber
	Dim Img As System.Drawing.Bitmap = pageResult.BarcodeImage
	Dim BarcodeType As BarcodeEncoding = pageResult.BarcodeType
	Dim Binary() As Byte = pageResult.BinaryValue
	Console.WriteLine(pageResult.Value & " on page " & PageNum)
Next pageResult

Imports IronBarCode
Imports System

' Multiple barcodes may be scanned up from a single document or image. A PDF document may also used as the input image
Private results As BarcodeResults = BarcodeReader.ReadPdf("MultipleBarcodes.pdf")

' Work with the results
For Each pageResult In results
	Dim Value As String = pageResult.Value
	Dim PageNum As Integer = pageResult.PageNumber
	Dim Img As System.Drawing.Bitmap = pageResult.BarcodeImage
	Dim BarcodeType As BarcodeEncoding = pageResult.BarcodeType
	Dim Binary() As Byte = pageResult.BinaryValue
	Console.WriteLine(pageResult.Value & " on page " & PageNum)
Next pageResult

Código QR girado 45 grados demostrando el manejo de rotación de IronBarcode

Un código QR girado que IronBarcode lee correctamente utilizando opciones avanzadas

La propiedad ExpectBarcodeTypes mejora significativamente el rendimiento al limitar la búsqueda a formatos específicos. Para obtener la máxima precisión con imágenes problemáticas, combina filtros de imagen con rotación automática:

using IronBarCode;

// Multi frame TIFF and GIF images can also be scanned
BarcodeResults multiFrameResults = BarcodeReader.Read("Multiframe.tiff");

foreach (var pageResult in multiFrameResults)
{
    //...
}

using IronBarCode;

// Multi frame TIFF and GIF images can also be scanned
BarcodeResults multiFrameResults = BarcodeReader.Read("Multiframe.tiff");

foreach (var pageResult in multiFrameResults)
{
    //...
}

Imports IronBarCode

' Multi frame TIFF and GIF images can also be scanned
Private multiFrameResults As BarcodeResults = BarcodeReader.Read("Multiframe.tiff")

For Each pageResult In multiFrameResults
	'...
Next pageResult

Imports IronBarCode

' Multi frame TIFF and GIF images can also be scanned
Private multiFrameResults As BarcodeResults = BarcodeReader.Read("Multiframe.tiff")

For Each pageResult In multiFrameResults
	'...
Next pageResult

Estas características avanzadas hacen que IronBarcode sea ideal para escanear códigos de barras desde fotos, cámaras de seguridad o capturas de dispositivos móviles donde la calidad de la imagen varía significativamente.

¿Cómo escaneo varios códigos de barras de documentos PDF?

El escaneo de códigos de barras en PDF es esencial para procesar facturas, etiquetas de envío y documentos de inventario. IronBarcode lee todos los códigos de barras en cada página de manera eficiente.

Lectura de códigos de barras de archivos PDF

using IronBarCode;

// The Multithreaded property allows for faster barcode scanning across multiple images or PDFs. All threads are automatically managed by IronBarCode.
var ListOfDocuments = new[] { "image1.png", "image2.JPG", "image3.pdf" };

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Enable multithreading
    Multithreaded = true,
};

BarcodeResults batchResults = BarcodeReader.Read(ListOfDocuments, options);

using IronBarCode;

// The Multithreaded property allows for faster barcode scanning across multiple images or PDFs. All threads are automatically managed by IronBarCode.
var ListOfDocuments = new[] { "image1.png", "image2.JPG", "image3.pdf" };

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Enable multithreading
    Multithreaded = true,
};

BarcodeResults batchResults = BarcodeReader.Read(ListOfDocuments, options);

Imports IronBarCode

' The Multithreaded property allows for faster barcode scanning across multiple images or PDFs. All threads are automatically managed by IronBarCode.
Private ListOfDocuments = { "image1.png", "image2.JPG", "image3.pdf" }

Private options As New BarcodeReaderOptions() With {.Multithreaded = True}

Private batchResults As BarcodeResults = BarcodeReader.Read(ListOfDocuments, options)

Imports IronBarCode

' The Multithreaded property allows for faster barcode scanning across multiple images or PDFs. All threads are automatically managed by IronBarCode.
Private ListOfDocuments = { "image1.png", "image2.JPG", "image3.pdf" }

Private options As New BarcodeReaderOptions() With {.Multithreaded = True}

Private batchResults As BarcodeResults = BarcodeReader.Read(ListOfDocuments, options)

Múltiples códigos de barras detectados en páginas PDF mostrando salida de consola Salida de consola mostrando múltiples códigos de barras encontrados en diferentes páginas PDF

Para rangos de páginas específicos o procesamiento avanzado de PDF, utiliza BarcodeReaderOptions:

// Read only specific pages to improve performance
PdfBarcodeReaderOptions pdfOptions = new PdfBarcodeReaderOptions
{
    // Scan pages 1-5 only
    PageNumbers = new[] { 1, 2, 3, 4, 5 },

    // PDF-specific settings
    DPI = 300 // Higher DPI for better accuracy
};

BarcodeResults results = BarcodeReader.ReadPdf("document.pdf", pdfOptions);

// Read only specific pages to improve performance
PdfBarcodeReaderOptions pdfOptions = new PdfBarcodeReaderOptions
{
    // Scan pages 1-5 only
    PageNumbers = new[] { 1, 2, 3, 4, 5 },

    // PDF-specific settings
    DPI = 300 // Higher DPI for better accuracy
};

BarcodeResults results = BarcodeReader.ReadPdf("document.pdf", pdfOptions);

¿Cómo puedo procesar imágenes TIFF multicuadro?

Los archivos TIFF multiframes, comunes en el escaneo de documentos y sistemas de fax, reciben el mismo soporte integral que los PDF.

TIFF multiframe que contiene múltiples códigos de barras en los cuadros Un archivo TIFF multiframe con códigos de barras en diferentes fotogramas

using IronBarCode;

// TIFF files are processed similarly to regular images
// Each frame is scanned automatically
BarcodeResults multiFrameResults = BarcodeReader.Read("Multiframe.tiff");

foreach (var result in multiFrameResults)
{
    // Access frame-specific information
    int frameNumber = result.PageNumber; // Frame number in TIFF
    string barcodeValue = result.Text;
    
    Console.WriteLine($"Frame {frameNumber}: {barcodeValue}");
    
    // Save individual barcode images if needed
    result.BarcodeImage?.Save($"barcode_frame_{frameNumber}.png");
}

using IronBarCode;

// TIFF files are processed similarly to regular images
// Each frame is scanned automatically
BarcodeResults multiFrameResults = BarcodeReader.Read("Multiframe.tiff");

foreach (var result in multiFrameResults)
{
    // Access frame-specific information
    int frameNumber = result.PageNumber; // Frame number in TIFF
    string barcodeValue = result.Text;
    
    Console.WriteLine($"Frame {frameNumber}: {barcodeValue}");
    
    // Save individual barcode images if needed
    result.BarcodeImage?.Save($"barcode_frame_{frameNumber}.png");
}

Imports IronBarCode

' TIFF files are processed similarly to regular images
' Each frame is scanned automatically
Dim multiFrameResults As BarcodeResults = BarcodeReader.Read("Multiframe.tiff")

For Each result In multiFrameResults
    ' Access frame-specific information
    Dim frameNumber As Integer = result.PageNumber ' Frame number in TIFF
    Dim barcodeValue As String = result.Text

    Console.WriteLine($"Frame {frameNumber}: {barcodeValue}")

    ' Save individual barcode images if needed
    result.BarcodeImage?.Save($"barcode_frame_{frameNumber}.png")
Next

Imports IronBarCode

' TIFF files are processed similarly to regular images
' Each frame is scanned automatically
Dim multiFrameResults As BarcodeResults = BarcodeReader.Read("Multiframe.tiff")

For Each result In multiFrameResults
    ' Access frame-specific information
    Dim frameNumber As Integer = result.PageNumber ' Frame number in TIFF
    Dim barcodeValue As String = result.Text

    Console.WriteLine($"Frame {frameNumber}: {barcodeValue}")

    ' Save individual barcode images if needed
    result.BarcodeImage?.Save($"barcode_frame_{frameNumber}.png")
Next

Se aplican las mismas BarcodeReaderOptions al procesamiento de TIFF, incluyendo filtros de imagen y configuraciones de rotación. Para escenarios detallados de manejo TIFF, consulta nuestros tutoriales de procesamiento de imágenes.

¿Puedo acelerar el procesamiento con subprocesos múltiples?

El procesamiento de múltiples documentos se beneficia significativamente del procesamiento en paralelo. IronBarcode utiliza automáticamente los núcleos de CPU disponibles para un rendimiento óptimo.

using IronBarCode;

// List of documents to process - mix of formats supported
var documentBatch = new[] 
{ 
    "invoice1.pdf", 
    "shipping_label.png", 
    "inventory_sheet.tiff",
    "product_catalog.pdf"
};

// Configure for batch processing
BarcodeReaderOptions batchOptions = new BarcodeReaderOptions
{
    // Enable parallel processing across documents
    Multithreaded = true,
    
    // Limit threads if needed (0 = use all cores)
    MaxParallelThreads = Environment.ProcessorCount,
    
    // Apply consistent settings to all documents
    Speed = ReadingSpeed.Balanced,
    ExpectBarcodeTypes = BarcodeEncoding.All
};

// Process each document, tracking the source path externally
foreach (var document in documentBatch)
{
    BarcodeResults results = BarcodeReader.Read(document, batchOptions);

    Console.WriteLine($"\nDocument: {document}");
    foreach (var barcode in results)
    {
        Console.WriteLine($"  - {barcode.BarcodeType}: {barcode.Text}");
    }
}

using IronBarCode;

// List of documents to process - mix of formats supported
var documentBatch = new[] 
{ 
    "invoice1.pdf", 
    "shipping_label.png", 
    "inventory_sheet.tiff",
    "product_catalog.pdf"
};

// Configure for batch processing
BarcodeReaderOptions batchOptions = new BarcodeReaderOptions
{
    // Enable parallel processing across documents
    Multithreaded = true,
    
    // Limit threads if needed (0 = use all cores)
    MaxParallelThreads = Environment.ProcessorCount,
    
    // Apply consistent settings to all documents
    Speed = ReadingSpeed.Balanced,
    ExpectBarcodeTypes = BarcodeEncoding.All
};

// Process each document, tracking the source path externally
foreach (var document in documentBatch)
{
    BarcodeResults results = BarcodeReader.Read(document, batchOptions);

    Console.WriteLine($"\nDocument: {document}");
    foreach (var barcode in results)
    {
        Console.WriteLine($"  - {barcode.BarcodeType}: {barcode.Text}");
    }
}

Este enfoque paralelo procesa documentos simultáneamente, reduciendo el tiempo total de escaneo hasta en un 75% en sistemas multicore. Para procesamiento de códigos de barras a escala empresarial, explora nuestra guía de optimización de rendimiento.

Resumen

IronBarcode transforma el escaneo complejo de códigos de barras en código C# sencillo. Ya sea que estés construyendo sistemas de inventario, procesadores de documentos o aplicaciones móviles, la biblioteca maneja todo, desde códigos de barras digitales impecables hasta capturas desafiantes del mundo real.

Capacidades clave cubiertas:

Lectura de códigos de barras desde imágenes
Opciones avanzadas para códigos de barras dañados o rotados
Escaneo integral de documentos PDF y TIFF
Procesamiento por lotes de alto rendimiento con multihilo
Soporte para formatos de códigos de barras principales

Lecturas adicionales

Amplía tus capacidades de procesamiento de códigos de barras con estos recursos:

Tutorial de Generación de Códigos de Barras - Crea códigos de barras personalizados
Guía de Código QR - Características especializadas de códigos QR
Referencia de la clase BarcodeReader - Documentación completa de la API
Guía de Solución de Problemas - Problemas comunes y soluciones

Descargas de código fuente

Ejecuta estos ejemplos tú mismo:

¿Listo para implementar el escaneo de códigos de barras en tu aplicación? Comienza tu prueba gratuita y añade lectura profesional de códigos de barras a tu proyecto .NET hoy.

Primer Paso:

Preguntas Frecuentes

¿Cómo puedo instalar una biblioteca de lectura de códigos de barras en un proyecto .NET?

Puede instalar la biblioteca IronBarcode a través del Administrador de Paquetes NuGet usando el comando dotnet add package BarCode o través de la interfaz de NuGet de Visual Studio. Alternativamente, descargue el DLL para la instalación manual.

¿Cuál es el método para leer un código de barras desde una imagen usando C#?

Utilice el método BarcodeReader.Read de IronBarcode con una sola línea de código: var results = BarcodeReader.Read('image.png'); Este método detecta y lee todos los formatos de códigos de barras presentes en la imagen.

¿Es posible detectar múltiples códigos de barras en una sola imagen o documento?

Sí, IronBarcode puede detectar y leer automáticamente múltiples códigos de barras en una imagen, PDF o TIFF de múltiples fotogramas, devolviendo el valor, el tipo y la posición de cada código de barras en una colección BarcodeResults.

¿Cómo leo códigos de barras de un PDF usando C#?

Utilice el método BarcodeReader.ReadPdf de IronBarcode para escanear todas las páginas de un documento PDF: var results = BarcodeReader.ReadPdf('document.pdf'); Cada resultado incluye el número de página donde se encontró el código de barras.

¿Qué debo hacer si las imágenes de los códigos de barras están borrosas o rotadas?

Configure BarcodeReaderOptions para manejar imágenes desafiantes estableciendo AutoRotate = true y aplicando filtros de imagen como SharpenFilter o AdaptiveThresholdFilter. Utilice Speed = ExtremeDetail para mayor precisión.

¿Qué formatos de códigos de barras son compatibles en aplicaciones .NET?

IronBarcode es compatible con todos los formatos principales de códigos de barras, como QR Code, Code 128, Code 39, EAN-13, UPC-A, Data Matrix, PDF417 y más. Utilice BarcodeEncoding.All para escanear cualquier formato compatible.

¿Cómo puedo mejorar el rendimiento de escaneo de códigos de barras en una aplicación C#?

Mejore el rendimiento especificando tipos de códigos de barras esperados con ExpectBarcodeTypes, habilitando el procesamiento Multithreaded y eligiendo configuraciones de Speed adecuadas. Para tareas por lotes, utilice BarcodeReader.Read con rutas de archivo.

¿Cuál es el enfoque recomendado para manejar errores de lectura de códigos de barras?

Encapsule la lectura de códigos de barras en bloques try-catch y verifique si los resultados son nulos o vacíos. IronBarcode proporciona mensajes de error detallados y una propiedad Confidence para indicar la fiabilidad de la detección.

¿Puedo extraer imágenes de códigos de barras después de que se escanean?

Sí, el BarcodeResult de IronBarcode incluye una propiedad BarcodeImage que contiene un Bitmap del código de barras detectado, que puede ser guardado o procesado por separado.

¿Cómo leo códigos de barras de páginas específicas dentro de un documento PDF?

Establezca la propiedad PageNumbers en BarcodeReaderOptions para especificar páginas: options.PageNumbers = new[] {1, 2, 3}; Esto optimiza el rendimiento al escanear solo las páginas designadas.

¿Qué formatos de imagen son compatibles con el escaneo de códigos de barras en .NET?

IronBarcode admite el escaneo en formatos como PNG, JPEG, BMP, GIF, TIFF (incluidos los de varios fotogramas) y PDF. Puede cargar imágenes desde rutas de archivo, flujos o arreglos de bytes.

¿Cómo puedo acceder a los datos binarios de los códigos de barras escaneados en C#?

Utilice la propiedad BinaryValue de BarcodeResult para obtener los datos binarios en bruto, especialmente útil para códigos de barras que contienen datos no textuales como información comprimida o protocolos binarios.

Jacob Mellor

Chatea con el equipo de ingeniería ahora

Director de Tecnología

Jacob Mellor es Director de Tecnología de Iron Software y un ingeniero visionario pionero en la tecnología C# PDF. Como desarrollador original de la base de código principal de Iron Software, ha dado forma a la arquitectura de productos de la empresa desde su creación, transformándola, junto con el director ejecutivo Cameron Rimington, en una empresa de más de 50 personas que presta servicios a la NASA, Tesla y organismos gubernamentales de todo el mundo.

...