Comment utiliser Async et Multithread en C# ; avec IronBarcode

Comment lire des BarCodes de manière asynchrone avec IronBarcode?

La lecture asynchrone permet aux opérations longues ou bloquantes de se poursuivre sans bloquer l'exécution du thread principal. En C#, utilisez les mots-clés async et await avec les méthodes prenant en charge les fonctionnalités asynchrones. Cette approche ne crée pas de fils de discussion supplémentaires, mais libère le fil de discussion actuel. Bien que le fil d'exécution principal initie et gère des tâches, il ne reste pas exclusivement consacré à une seule tâche. Le thread principal revient lorsque la méthode asynchrone requiert son intervention, ce qui lui permet de se consacrer à d'autres tâches lorsqu'il n'en a pas besoin, ce qui est particulièrement utile pour les tâches liées aux E/S, telles que la lecture/écriture de fichiers ou les requêtes réseau.

Prenons l'exemple de la lecture de codes-barres. Le processus implique :

• Lecture du fichier
• Application des options de lecture
• Décodage du code-barres

Pendant la lecture du fichier, la tâche principale peut être libérée. Cela profite aux scénarios comportant plusieurs fichiers d'images ou des PDF volumineux, comme le démontre notre tutoriel sur la lecture des codes-barres.

Utilisez les méthodes ReadAsync et ReadPdfAsync pour lire les Barcodes de manière asynchrone respectivement pour les images et les documents PDF. Avant de mettre en œuvre des opérations asynchrones, assurez-vous d'avoir installé IronBarcode via NuGet dans votre projet.

: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

L'extrait de code ci-dessus instancie un List de chemins d'accès aux images à lire de manière asynchrone par IronBarcode. Pour lire les images, utilisez la méthode ReadAsync de la classe BarcodeReader. Spécifiez les options imagePaths et de lecture. Pour les options de configuration avancées, consultez notre guide sur les paramètres du lecteur de codes-barres.

Cette méthode d'opération asynchrone est également disponible pour la lecture de BarCodes dans des documents PDF via ReadPdfAsync dans la même classe. Pour les configurations de lecture PDF spécifiques, consultez notre Guide des paramètres du lecteur de codes-barres PDF.

Multithreaded
MaxParallelThreads

Comment activer la lecture multithread des BarCodes?

Contrairement aux opérations asynchrones, le multithreading exécute un processus unique sur plusieurs threads simultanément. Au lieu d'une exécution séquentielle dans un seul thread, le multithreading répartit les tâches entre plusieurs threads pour une exécution simultanée. Le multithreading nécessite plusieurs cœurs d'unité centrale, car ces cœurs exécutent indépendamment les threads. Tout comme les opérations asynchrones, le multithreading améliore les performances et la réactivité des applications.

Dans IronBarcode, activez le multithreading en définissant la propriété Multithreaded et en spécifiant le nombre maximal de cœurs pour l'exécution simultanée à l'aide de MaxParallelThreads dans BarcodeReaderOptions. La valeur par défaut de MaxParallelThreads est 4, ajustable en fonction des cœurs de processeur disponibles. Pour des configurations de performances optimales, consultez notre guide des options de vitesse de lecture.

: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

Quel est le niveau d'amélioration des performances auquel je peux m'attendre ?

Lisons deux exemples d'images et comparons les temps de lecture pour des opérations normales, asynchrones et multithread.


Lecture normale	Lecture asynchrone	Lecture multithread (4 cœurs)
1,75 seconde	1,67 seconde	1,17 seconde

La comparaison montre une augmentation significative des performances avec la lecture asynchrone et multithread. Le multithreading apporte une amélioration d'environ 33 % par rapport à la lecture normale, tandis que l'asynchrone apporte une amélioration d'environ 5 %. Cependant, ces opérations ont des objectifs et des approches différents. Choisissez l'approche qui correspond le mieux aux exigences de votre application. Les améliorations de performance varient en fonction de : - Nombre d'images traitées - Complexité de l'image et qualité du BarCode - Cœurs de processeur disponibles - Autres ressources système Pour les situations avec plusieurs codes-barres sur un même document, consultez le guide [Lire plusieurs codes-barres](https://ironsoftware.com/csharp/barcode/how-to/read-multiple-barcodes/). ### Quand choisir le multithreading plutôt que les opérations asynchrones? Choisissez le multithreading lorsque : 1. **Opérations dépendantes du CPU** : Le traitement implique des calculs intensifs comme des filtres d'image complexes ou des images haute résolution 2. **Traitement par lots** : Plusieurs images indépendantes nécessitent un traitement simultané 3. **Systèmes Multicœurs** : L'environnement de déploiement dispose de plusieurs cœurs CPU disponibles 4. **Critique de Performance** : La vitesse de traitement brute l'emporte sur l'efficacité des ressources Choisissez les opérations asynchrones lorsque : 1. **Opérations dépendantes de l'I/O** : La plupart du temps implique la lecture de fichiers ou l'attente de réponses réseau 2. **Applications UI** : Maintenir des interfaces utilisateur réactives est crucial 3. **Ressources Limitées** : Fonctionner sur des systèmes avec des cœurs CPU limités 4. **Applications web** : Traitement efficace de plusieurs requêtes simultanées ### Comment déterminer la valeur optimale de MaxParallelThreads? La valeur optimale de `MaxParallelThreads` dépend de plusieurs facteurs : 1. **Cœurs de processeur disponibles** : commencez par `` comme valeur de référence 2. **Type de Charge de Travail** : Pour une lecture pure de code-barres, utilisez 75 % des cœurs disponibles 3. **Ressources Système** : Laissez de la place pour le système d'exploitation et d'autres processus 4. **Résultats des Tests** : Faire un benchmark avec votre charge de travail spécifique Voici une approche pratique pour trouver la valeur optimale : ```csharp int optimalThreads = Math.Max(1, Environment.ProcessorCount - 1); ``` Pour les environnements de production, surveillez les performances et ajustez-les en fonction des schémas d'utilisation réels. Envisagez de mettre en œuvre [la configuration des clés de licence](https://ironsoftware.com/csharp/barcode/get-started/license-keys/) pour les déploiements en entreprise nécessitant des performances maximales. Pour connaître les capacités complètes de l'API, consultez la [référence de l'API IronBarcode](https://ironsoftware.com/csharp/barcode/object-reference/api/).