Cómo usar Async y Multithread en C# con IronBarcode

Ejemplo de lectura asincrónica de códigos de barras

Comencemos entendiendo qué es la lectura asincrónica y cómo beneficia a los usuarios. La lectura asincrónica permite que las operaciones largas o bloqueantes se realicen sin bloquear la ejecución del hilo principal. En C#, los usuarios pueden utilizar las palabras clave async y await con métodos que admiten características asincrónicas. Esto no creará hilos adicionales, sino que liberará el hilo actual. Si bien el hilo principal todavía es necesario para iniciar y administrar tareas, no necesita estar exclusivamente dedicado a una sola tarea. El hilo principal se convoca cuando el método asincrónico requiere su participación, liberándolo para manejar otras tareas cuando no es necesario, como tareas dependientes de I/O como leer/escribir archivos o realizar solicitudes de red.

Consideremos la lectura de códigos de barras como un ejemplo. En este escenario, los pasos involucrados serían:

• Leer el archivo
• Aplicar opciones de lectura
• Decodificar el código de barras

Durante el paso de 'Leer el archivo', la tarea principal puede ser liberada.

Utilice los métodos ReadAsync y ReadPdfAsync para leer códigos de barras asincrónicamente para imágenes y documentos PDF, respectivamente.

:path=/static-assets/barcode/content-code-examples/how-to/async-multithread-async.cs

using IronBarCode;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;

List<string> imagePaths = new List<string>() { "image1.png", "image2.png" };

// Barcode reading options
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    ExpectMultipleBarcodes = true
};

// Read barcode using Async
BarcodeResults asyncResult = await BarcodeReader.ReadAsync(imagePaths, options);

// Print the results to console
foreach (var result in asyncResult)
{
    Console.WriteLine(result.ToString());
}

Imports IronBarCode
Imports System
Imports System.Collections.Generic
Imports System.Threading.Tasks

Private imagePaths As New List(Of String)() From {"image1.png", "image2.png"}

' Barcode reading options
Private options As New BarcodeReaderOptions() With {.ExpectMultipleBarcodes = True}

' Read barcode using Async
Private asyncResult As BarcodeResults = await BarcodeReader.ReadAsync(imagePaths, options)

' Print the results to console
For Each result In asyncResult
	Console.WriteLine(result.ToString())
Next result

En el fragmento de código anterior, hemos instanciado una lista de rutas de imágenes para ser leídas asincrónicamente por IronBarcode. Para leer las imágenes, puede usar el método ReadAsync de la clase BarcodeReader. Los usuarios pueden especificar las imagePaths así como las opciones de lectura.

Este método para operaciones asincrónicas también está disponible para leer códigos de barras en documentos PDF, conocido como ReadPdfAsync, que forma parte de la misma clase.

Ejemplo de lectura de códigos de barras en multiproceso

A diferencia de las operaciones asincrónicas, el multihilo permite que un único proceso se ejecute en múltiples hilos simultáneamente. Esto significa que, en lugar de ejecutar un proceso secuencialmente en un solo hilo, el multihilo divide las tareas entre varios hilos, permitiendo la ejecución concurrente. Sin embargo, para que el multihilo funcione, una máquina debe tener múltiples núcleos de CPU, ya que estos núcleos se utilizan para ejecutar los hilos de forma independiente. Similar a las operaciones asincrónicas, el multihilo busca mejorar el rendimiento y la capacidad de respuesta de las aplicaciones.

En IronBarcode, active el multihilo configurando la propiedad Multithreaded y especificando los núcleos máximos para ejecución concurrente utilizando MaxParallelThreads en BarcodeReaderOptions. El valor predeterminado para MaxParallelThreads es 4, que se puede ajustar según los núcleos de CPU disponibles.

:path=/static-assets/barcode/content-code-examples/how-to/async-multithread-multithread.cs

using IronBarCode;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;

List<string> imagePaths = new List<string>(){"test1.jpg", "test2.png"};

// Barcode reading options
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    Multithreaded = true,
    MaxParallelThreads = 4,
    ExpectMultipleBarcodes = true
};

// Read barcode with multithreaded enabled
BarcodeResults results = BarcodeReader.Read(imagePaths, options);

// Print the results to console
foreach (var result in results)
{
    Console.WriteLine(result.ToString());
}

Imports IronBarCode
Imports System
Imports System.Collections.Generic
Imports System.Threading.Tasks

Private imagePaths As New List(Of String)() From {"test1.jpg", "test2.png"}

' Barcode reading options
Private options As New BarcodeReaderOptions() With {
	.Multithreaded = True,
	.MaxParallelThreads = 4,
	.ExpectMultipleBarcodes = True
}

' Read barcode with multithreaded enabled
Private results As BarcodeResults = BarcodeReader.Read(imagePaths, options)

' Print the results to console
For Each result In results
	Console.WriteLine(result.ToString())
Next result

Comparación de rendimiento

Ahora, leamos las dos imágenes a continuación y comparemos el tiempo de lectura de operaciones normales, asincrónicas y multihilos.

Imagen de muestra

Lectura normal	Lectura asincrónica	Lectura multiproceso (4 núcleos)
01,75 segundos	01,67 segundos	01,17 segundos

De la tabla de comparación, es evidente que hay un aumento significativo en el rendimiento una vez que se implementa la lectura asincrónica y multihilo. Sin embargo, estas dos operaciones sirven para propósitos y enfoques diferentes. Por lo tanto, los usuarios deben determinar qué enfoque se adapta mejor a la aplicación que están construyendo.

Finalmente, puede haber situaciones en las que múltiples códigos de barras estén presentes en un único documento. Para más información, visite la guía Leer Múltiples Códigos de Barra.