Prise en charge Async & Multithreading C# avec IronOCR

Chipego
Chipego Kalinda
Mis à jour : 26 août 2026

IronOCR gère automatiquement le multithreading sur tous les cœurs du CPU et fournit des méthodes asynchrones comme ReadAsync() pour effectuer l'OCR sans bloquer votre fil principal, garantissant des applications réactives tout en traitant de grands documents. Pour les charges de travail contraintes par la mémoire, les propriétés MaxDegreeOfParallelism et MultiThreaded sur IronTesseract limitent le nombre de pages lues simultanément.

Introduction

Traiter efficacement de grands volumes de données textuelles nécessite à la fois précision et rapidité pour les opérations OCR. Cet article traite de la prise en charge asynchrone et du multithreading dans IronOCR et Tesseract. La programmation asynchrone permet une exécution non bloquante de l'OCR, ce qui permet aux applications de rester réactives pendant les tâches de reconnaissance de texte. Le multithreading offre un parallélisme qui permet d'augmenter considérablement les performances de l'OCR. Ces techniques aident les développeurs à améliorer l'efficacité et la réactivité des applications basées sur l'OCR.

Démarrage rapide : Utilisez ReadAsync pour un OCR asynchrone sans effort

Utilisez la méthode ReadAsync de IronTesseract pour effectuer l'OCR sans bloquer votre fil principal. Cela permet d'ajouter rapidement une reconnaissance optique de caractères réactive et non bloquante à votre application. Cela fonctionne particulièrement bien lors du traitement de documents PDF ou de la gestion simultanée de plusieurs fichiers image.

  1. 1Installez IronOCR avec NuGet Package Manager

    PM > Install-Package IronOcr

  2. 2Copiez et exécutez cet extrait de code.

    var result = await new IronOcr.IronTesseract().ReadAsync("image.png");
  3. 3Déployez pour tester sur votre environnement de production.

    Commencez à utiliser IronOCR dans votre projet dès aujourd'hui avec un essai gratuit
    arrow pointer

Comment fonctionne le multithreading dans IronOCR?

IronOCR améliore l'efficacité du traitement d'images et de lecture OCR grâce à un multithreading fluide, ne nécessitant aucune API spécialisée de la part des développeurs pour commencer. IronTesseract utilise automatiquement tous les fils disponibles sur plusieurs cœurs par défaut, optimisant les ressources système pour une exécution rapide de l'OCR. Le multithreading intégré simplifie le développement et augmente considérablement les performances en intégrant le parallélisme directement dans le flux de travail de l'OCR. Lorsque vous devez restreindre ce parallélisme - dans un conteneur à mémoire limitée ou un hôte partagé, par exemple - consultez la section sur le contrôle du parallélisme et l'utilisation de la mémoire ci-dessous.

L'implémentation Tesseract multithreadée de la bibliothèque offre ces avantages clés :

  • Utilisation automatique des cœurs CPU : IronOCR détecte et utilise tous les cœurs disponibles sans configuration manuelle, et vous permet de limiter cela avec MaxDegreeOfParallelism si besoin
  • Opérations thread-safe : Les opérations OCR sont thread-safe, et une instance unique de IronTesseract peut être partagée en toute sécurité entre plusieurs lectures simultanées
  • Empreinte mémoire ajustable : Chaque page lue en parallèle utilise son propre moteur Tesseract natif, donc la mémoire maximale se réajuste avec le degré de parallélisme - diminuez-le pour échanger le débit contre un ensemble de travail plus petit
  • Performance évolutive : Le temps de traitement diminue proportionnellement avec le nombre de cœurs disponibles

Voici un exemple de lecture multithread en C# :

using IronOcr;
using System;

var ocr = new IronTesseract();

using (var input = new OcrPdfInput(@"example.pdf"))
{
    var result = ocr.Read(input);
    Console.WriteLine(result.Text);
};

Deux propriétés sur IronTesseract vous permettent d'ajuster ce comportement pour répondre à des exigences spécifiques de performance et de mémoire, présentées dans la section suivante. Pour un autre axe d'optimisation - sacrifiant un peu de précision pour la vitesse brute - consultez la configuration OCR rapide.

Comment contrôler le parallélisme et l'utilisation de la mémoire ?

Par défaut, IronTesseract lit autant de pages simultanément que la machine a de cœurs CPU, et chaque page concurrente exécute son propre moteur Tesseract natif. Deux propriétés vous permettent de limiter cela lorsque la mémoire est plus importante que le débit brut :

  • MaxDegreeOfParallelism limite le nombre de pages OCR'd simultanément dans un seul appel Read. Comme chaque page simultanée coûte un moteur, le réduire diminue directement la mémoire maximale.
  • MultiThreaded désactive totalement la lecture parallèle lorsqu'elle est définie sur false, offrant ainsi une empreinte la plus basse et la plus prévisible. Elle a la priorité sur MaxDegreeOfParallelism.
using IronOcr;

var ocr = new IronTesseract
{
    Language = OcrLanguage.English,
    MaxDegreeOfParallelism = 2 // OCR at most 2 pages at once per Read
};

using var input = new OcrInput();
input.LoadPdf("invoice.pdf");
var result = ocr.Read(input);
Avertissement: MultiThreaded n'avait aucun effet dans les versions précédentes - c'est maintenant un paramètre actif. Le code qui a défini MultiThreaded = false en espérant qu'il soit inerte lira séquentiellement après la mise à jour, sans avertissement du compilateur ni exception.
Veuillez noter: Ces propriétés limitent le parallélisme dans un seul appel Read. La concurrence entre plusieurs documents ou plusieurs appels Read reste de la responsabilité de votre application - combinez-les avec les modèles asynchrones ci-dessous.

Pour les valeurs par défaut, les règles de priorité entre les deux propriétés, les conseils pour choisir une valeur, et les détails de la AccessViolationException résolue dans l'OCR parallèle à haut volume, consultez comment limiter l'utilisation de mémoire OCR parallèle.

Comment utiliser la prise en charge de l'asynchronisme dans IronOCR?

La programmation asynchrone optimise les performances de l'OCR en permettant aux développeurs d'exécuter des tâches d'OCR sans bloquer le thread principal. Cela permet aux applications de rester réactives lors du traitement de documents volumineux ou d'images pour la reconnaissance de texte. La prise en charge asynchrone permet au système de gérer d'autres tâches pendant que les opérations d'OCR s'exécutent en arrière-plan. Cette capacité est cruciale lors de la mise en œuvre du suivi de progression OCR dans les interfaces utilisateur.

Cette section couvre l'intégration du support asynchrone dans IronOCR, en démontrant différentes méthodes pour rendre les services OCR non bloquants. Les capacités asynchrones d'IronOCR garantissent des performances optimales à la fois pour les applications de bureau nécessitant une réactivité pendant les opérations d'OCR et pour les services web gérant plusieurs requêtes d'OCR simultanées.

Quand devrais-je utiliser des objets OcrReadTask ?

Les objets OcrReadTask améliorent le contrôle et la flexibilité dans les processus OCR avec IronOCR. Ces objets encapsulent les opérations d'OCR, permettant une gestion efficace des tâches de reconnaissance de texte. Cette section démontre l'utilisation des objets OcrReadTask dans votre flux de travail IronOCR et montre comment ils initient et optimisent les tâches OCR. Les objets OcrReadTask aident à maximiser les capacités d'IronOCR lors de l'orchestration du traitement complexe de documents ou de l'ajustement fin de la réactivité des applications.

Les objets OcrReadTask fonctionnent le mieux lorsqu'ils sont :

  • Vous avez besoin d'un contrôle précis de l'exécution des tâches
  • Implémentant la fonctionnalité de jeton d'annulation pour les opérations annulables
  • Gestion de plusieurs opérations d'OCR simultanées avec des priorités différentes
  • Intégration avec des planificateurs de tâches ou des moteurs de flux de travail personnalisés
using IronOcr;

IronTesseract ocr = new IronTesseract();

OcrPdfInput largePdf = new OcrPdfInput("chapter1.pdf");

Func<OcrResult> reader = () =>
{
    return ocr.Read(largePdf);
};

OcrReadTask readTask = new OcrReadTask(reader.Invoke);
// Start the OCR task asynchronously
readTask.Start();

// Continue with other tasks while OCR is in progress
DoOtherTasks();

// Wait for the OCR task to complete and retrieve the result
OcrResult result = await Task.Run(() => readTask.Result);

Console.Write($"##### OCR RESULTS ###### \n {result.Text}");

largePdf.Dispose();
readTask.Dispose();

static void DoOtherTasks()
{
    // Simulate other tasks being performed while OCR is in progress
    Console.WriteLine("Performing other tasks...");
    Thread.Sleep(2000); // Simulating work for 2000 milliseconds
}

Comment utiliser la méthode ReadAsync ?

ReadAsync() fournit un mécanisme direct pour initier des opérations OCR de manière asynchrone. Sans threading ni gestion de tâches complexes, les développeurs peuvent intégrer l'OCR asynchrone dans leurs applications. Cette méthode permet d'éviter que le thread principal ne se bloque pendant les tâches d'OCR, ce qui garantit la réactivité des applications.

La méthode ReadAsync fonctionne bien pour :

  • Applications de bureau qui doivent maintenir la réactivité de l'interface utilisateur
  • Applications web gérant plusieurs requêtes OCR simultanées
  • Des scénarios de traitement par lots où le suivi de la progression est essentiel
  • Intégration des modèles modernes async/await dans les applications .NET
using IronOcr;
using System;
using System.Threading.Tasks;

IronTesseract ocr = new IronTesseract();

using (OcrPdfInput largePdf = new OcrPdfInput("PDFs/example.pdf"))
{
    var result = await ocr.ReadAsync(largePdf);
    DoOtherTasks();
    Console.Write($"##### OCR RESULTS ###### " +
                $"\n {result.Text}");
}

static void DoOtherTasks()
{
    // Simulate other tasks being performed while OCR is in progress
    Console.WriteLine("Performing other tasks...");
    System.Threading.Thread.Sleep(2000); // Simulating work for 2000 milliseconds
}

Pourquoi utiliser l'asynchronisme et le multithreading avec IronOCR?

La combinaison de la prise en charge asynchrone et du multithreading dans IronOCR offre de nombreux avantages pour le développement d'applications modernes :

Avantages en termes de performances:

  • Amélioration du débit : Traitez plusieurs documents simultanément sans bloquer
  • Meilleure utilisation des ressources : Maximisez l'utilisation du CPU sur tous les cœurs disponibles
  • Réduction de la latence : Commencez le traitement immédiatement sans attendre la fin des opérations précédentes
  • Architecture évolutive : Gérez des charges de travail croissantes sans modifications architecturales

Avantages du développement:

  • Code simplifié : Pas besoin de gérer les fils manuellement - IronOCR gère la complexité
  • Modèles modernes : Prise en charge complète des modèles async/await dans Tesseract 5 pour .NET
  • Intégration facile : Fonctionne avec l'infrastructure asynchrone existante de .NET
  • Solutions maintenables : Code clair et lisible qui suit les meilleures pratiques de .NET

Le multithreading dans IronOCR optimise considérablement les tâches d'OCR. Les capacités de multithreading intégrées, combinées avec des méthodes comme ReadAsync(), simplifient la gestion de grands volumes de données textuelles. Cette combinaison garantit que les applications restent réactives et efficaces, faisant d'IronOCR un outil efficace pour créer des logiciels haute performance avec des capacités de reconnaissance de texte efficaces. Pour commencer avec l'ensemble complet de fonctionnalités, consultez notre guide d'installation du package NuGet.

Questions fréquemment posées

À quoi sert la méthode ReadAsync dans IronOCR ?

La méthode ReadAsync dans IronOCR est utilisée pour effectuer des opérations OCR asynchrones sans bloquer le thread principal, garantissant que les applications restent réactives pendant les tâches de reconnaissance de texte.

Comment IronOCR gère-t-il le multithreading ?

IronOCR gère automatiquement le multithreading sur tous les cœurs CPU sans nécessiter de l'API spécialisée des développeurs, optimisant les ressources système et améliorant les performances de l'OCR.

Quels sont les principaux avantages du multithreading dans le traitement OCR ?

L'implémentation multithread d'IronOCR offre une utilisation automatique des cœurs CPU, des opérations sûres pour les threads, une empreinte mémoire ajustable via la propriété MaxDegreeOfParallelism, et des performances évolutives où le temps de traitement diminue proportionnellement avec les cœurs disponibles.

Pourquoi la programmation asynchrone est-elle importante pour l'OCR dans IronOCR ?

La programmation asynchrone dans IronOCR permet d'effectuer des tâches OCR sans bloquer le thread principal, gardant les applications réactives et permettant au système de gérer d'autres tâches pendant que les opérations OCR s'exécutent en arrière-plan.

Dois-je écrire un code spécial pour activer le multithreading pour l'OCR ?

Non, le multithreading est activé par défaut et ne nécessite aucune API spécialisée pour démarrer. La bibliothèque intègre le parallélisme directement dans le flux de travail OCR, gérant automatiquement les threads sur plusieurs cœurs pour des performances optimales. Si vous devez limiter ce parallélisme, réglez IronTesseract.MaxDegreeOfParallelism ou désactivez-le avec MultiThreaded.

Comment les objets OcrReadTask améliorent-ils les opérations OCR dans IronOCR ?

Les objets OcrReadTask dans IronOCR offrent un contrôle et une flexibilité accrus, permettant une gestion efficace des tâches de reconnaissance de texte, et sont particulièrement utiles pour gérer plusieurs opérations concurrentes ou annuler des tâches avec des tokens d'arrêt.

Comment puis-je limiter l'utilisation de la mémoire lors de l'OCR de grands lots en parallèle ?

Réglez IronTesseract.MaxDegreeOfParallelism pour limiter combien de pages sont OCRisées simultanément dans un seul appel Read, ou réglez MultiThreaded sur false pour lire séquentiellement. Chaque page simultanée utilise son propre moteur Tesseract natif, donc baisser la valeur réduit directement le pic de mémoire. Voir le guide sur la limitation de la mémoire OCR parallèle pour les valeurs par défaut et les règles de préséance.

Changer MultiThreaded à false change-t-il vraiment quelque chose ?

Oui. MultiThreaded n'avait aucun effet dans les versions antérieures mais est maintenant un paramètre actif. Le régler à false lit les pages séquentiellement sur un seul thread, offrant l'empreinte mémoire la plus faible et la plus prévisible, et il remplace MaxDegreeOfParallelism. Le code qui a réglé cette propriété en pensant qu'elle était inactive lira séquentiellement après la mise à niveau.

IronOCR est-il entièrement compatible avec .NET 10 ?

.NET 10 est pris en charge par IronOCR for .NET via sa dernière version 2025.12. Vous pouvez installer la bibliothèque à l'aide de NuGet (Install-Package IronOcr) et exécuter des méthodes asynchrones telles que ReadAsync() sous .NET 10 sans configuration particulière.

Prêt à commencer ?

Téléchargements NuGet 6,394,824Version :2026.11tout juste publié