Cómo Leer Códigos de Barras en C#

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

This article was translated from English: Does it need improvement?
Translated
View the article in English

¿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.

  1. Instala IronBarcode con el Administrador de Paquetes NuGet

    PM > Install-Package BarCode
  2. Copie y ejecute este fragmento de código.

    var results = IronBarCode.BarcodeReader.Read("path/to/barcode.png");
  3. Despliegue para probar en su entorno real

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

    arrow pointer

¿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.

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

:path=/static-assets/barcode/content-code-examples/tutorials/reading-barcodes-3.cs
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)
$vbLabelText   $csharpLabel

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.

:path=/static-assets/barcode/content-code-examples/tutorials/reading-barcodes-4.cs
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
$vbLabelText   $csharpLabel
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:

:path=/static-assets/barcode/content-code-examples/tutorials/reading-barcodes-5.cs
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
$vbLabelText   $csharpLabel

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

:path=/static-assets/barcode/content-code-examples/tutorials/reading-barcodes-6.cs
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)
$vbLabelText   $csharpLabel

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:

:path=/static-assets/barcode/content-code-examples/tutorials/reading-barcodes-7.cs
// 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);
Imports System

' Read only specific pages to improve performance
Dim pdfOptions As New PdfBarcodeReaderOptions With {
    ' Scan pages 1-5 only
    .PageNumbers = New Integer() {1, 2, 3, 4, 5},

    ' PDF-specific settings
    .DPI = 300 ' Higher DPI for better accuracy
}

Dim results As BarcodeResults = BarcodeReader.ReadPdf("document.pdf", pdfOptions)
$vbLabelText   $csharpLabel

¿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

:path=/static-assets/barcode/content-code-examples/tutorials/reading-barcodes-8.cs
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
$vbLabelText   $csharpLabel

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.

:path=/static-assets/barcode/content-code-examples/tutorials/reading-barcodes-9.cs
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}");
    }
}
Imports IronBarCode

' List of documents to process - mix of formats supported
Dim documentBatch = New String() {
    "invoice1.pdf",
    "shipping_label.png",
    "inventory_sheet.tiff",
    "product_catalog.pdf"
}

' Configure for batch processing
Dim batchOptions As New BarcodeReaderOptions With {
    ' 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
For Each document In documentBatch
    Dim results As BarcodeResults = BarcodeReader.Read(document, batchOptions)

    Console.WriteLine(vbCrLf & "Document: " & document)
    For Each barcode In results
        Console.WriteLine($"  - {barcode.BarcodeType}: {barcode.Text}")
    Next
Next
$vbLabelText   $csharpLabel

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:

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.

Empiece con IronBarcode ahora.
green arrow pointer

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, Director de Tecnología @ Team Iron
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, ...

Leer más
¿Listo para empezar?
Nuget Descargas 2,317,217 | Versión: 2026.7 recién lanzado
Still Scrolling Icon

¿Aún desplazándote?

¿Quieres una prueba rápida? PM > Install-Package BarCode
ejecuta una muestra observa cómo tu cadena se convierte en un código de barras.