Comment utiliser le suivi OcrProgress en C#

Comment utiliser le suivi de progression en C# avec IronOCR

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

IronOCR propose un événement permettant de s'abonner pour suivre la progression de l'opération de lecture OCR (reconnaissance optique de caractères). Ces propriétés offrent des informations précieuses sur l'avancement, la durée et l'état d'achèvement de la tâche OCR, permettant aux applications de surveiller et de rendre compte efficacement du processus OCR.

Démarrage rapide : abonnez-vous à OcrProgress et lisez le PDF

Cet exemple montre avec quelle facilité vous pouvez suivre la progression de la reconnaissance optique de caractères (OCR) avec IronOCR : abonnez-vous à son événement intégré OcrProgress et obtenez un retour d'information instantané (pourcentage, pages lues, nombre total de pages) pendant la lecture d'un PDF. Voici quelques lignes pour commencer.

Nuget IconCommencez dès maintenant à créer des PDF avec NuGet :

  1. Installez IronOCR avec le gestionnaire de packages NuGet

    PM > Install-Package IronOcr

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

    var ocr = new IronOcr.IronTesseract();
    ocr.OcrProgress += (s, e) => Console.WriteLine(e.ProgressPercent + "% (" + e.PagesComplete + "/" + e.TotalPages + ")");
    var result = ocr.Read(new IronOcr.OcrInput().LoadPdf("file.pdf"));
  3. Déployez pour tester sur votre environnement de production.

    Commencez à utiliser IronOCR dans votre projet dès aujourd'hui grâce à un essai gratuit.
    arrow pointer


Exemple de suivi des progrès

Il est possible de s'abonner à l'événement OcrProgress pour recevoir des mises à jour sur l'avancement du processus de lecture. The event will pass an instance containing information about the progress of the OCR job, such as the start time, total pages, progress as a percentage, duration, and end time. Let's use the following document as our sample: "Experiences in Biodiversity Research: A Field Course" by Thea B. Gessler, Université d'État de l'Iowa.

:path=/static-assets/ocr/content-code-examples/how-to/progress-tracking-progress-tracking.cs
using IronOcr;
using System;

var ocrTesseract = new IronTesseract();

// Subscribe to OcrProgress event
ocrTesseract.OcrProgress += (_, ocrProgressEventsArgs) =>
{
    Console.WriteLine("Start time: " + ocrProgressEventsArgs.StartTimeUTC.ToString());
    Console.WriteLine("Total pages number: " + ocrProgressEventsArgs.TotalPages);
    Console.WriteLine("Progress(%) | Duration");
    Console.WriteLine("    " + ocrProgressEventsArgs.ProgressPercent + "%     | " + ocrProgressEventsArgs.Duration.TotalSeconds + "s");
    Console.WriteLine("End time: " + ocrProgressEventsArgs.EndTimeUTC.ToString());
    Console.WriteLine("----------------------------------------------");
};

using var input = new OcrInput();
input.LoadPdf("Experiences-in-Biodiversity-Research-A-Field-Course.pdf");

// Progress events will fire during the read operation
var result = ocrTesseract.Read(input);
Imports IronOcr
Imports System

Private ocrTesseract = New IronTesseract()

' Subscribe to OcrProgress event
Private ocrTesseract.OcrProgress += Sub(underscore, ocrProgressEventsArgs)
	Console.WriteLine("Start time: " & ocrProgressEventsArgs.StartTimeUTC.ToString())
	Console.WriteLine("Total pages number: " & ocrProgressEventsArgs.TotalPages)
	Console.WriteLine("Progress(%) | Duration")
	Console.WriteLine("    " & ocrProgressEventsArgs.ProgressPercent & "%     | " & ocrProgressEventsArgs.Duration.TotalSeconds & "s")
	Console.WriteLine("End time: " & ocrProgressEventsArgs.EndTimeUTC.ToString())
	Console.WriteLine("----------------------------------------------")
End Sub

Private input = New OcrInput()
input.LoadPdf("Experiences-in-Biodiversity-Research-A-Field-Course.pdf")

' Progress events will fire during the read operation
Dim result = ocrTesseract.Read(input)
$vbLabelText   $csharpLabel
Mise à jour des progrès

Informations relatives à l'événement

  • ProgressPercent : Représente la progression de la tâche OCR en pourcentage des pages traitées. Elle varie de 0 à 100.
  • TotalPages : Indique le nombre total de pages traitées par le moteur OCR.
  • PagesComplete : Indique le nombre de pages dont la lecture OCR a été entièrement effectuée. Ce nombre peut augmenter progressivement au fur et à mesure du traitement des pages.
  • Duration : Représente la durée totale de la tâche OCR, indiquant le temps nécessaire à l'exécution complète du processus. Elle est mesurée au format TimeSpan. Cette heure est mise à jour à chaque déclenchement de l'événement.
  • StartTimeUTC : Indique la date et l'heure de début de la tâche OCR, représentées au format Temps universel coordonné (UTC).
  • EndTimeUTC : Représente la date et l'heure auxquelles la tâche OCR a été achevée à 100 % au format UTC. Cette propriété est nulle pendant le processus de reconnaissance optique de caractères (OCR) et est renseignée une fois ce processus terminé.

Questions Fréquemment Posées

Comment puis-je suivre la progression d'une tâche OCR en C# ?

Vous pouvez suivre la progression d'une tâche OCR en C# en vous abonnant à l'événement OcrProgress dans IronOCR. Cet événement fournit des mises à jour sur le pourcentage de réalisation, la durée et le nombre de pages traitées.

Quel est le rôle de l'événement OcrProgress dans les opérations OCR ?

L'événement OcrProgress dans IronOCR permet aux développeurs de recevoir des mises à jour en temps réel sur l'état de la tâche OCR, y compris le pourcentage de progression, la durée totale, les heures de début et de fin, et le nombre total de pages en cours de traitement.

Quelles informations fournit la propriété ProgressPercent ?

La propriété ProgressPercent dans IronOCR indique la progression de la tâche OCR en pourcentage, offrant une vue claire de l'avancement de la tâche, allant de 0 à 100.

Comment puis-je obtenir la durée totale d'un processus OCR ?

Vous pouvez obtenir la durée totale d'un processus OCR en accédant à la propriété Duration dans IronOCR, qui se met à jour chaque fois que l'événement OcrProgress est déclenché, reflétant le temps pris pour l'ensemble du processus.

Puis-je déterminer quand une tâche OCR commence et se termine ?

Oui, IronOCR fournit les propriétés StartTimeUTC et EndTimeUTC, qui indiquent respectivement les heures de début et de fin de la tâche OCR au format UTC.

Comment puis-je gérer plusieurs pages pendant le traitement OCR ?

Dans IronOCR, vous pouvez gérer plusieurs pages en utilisant les propriétés TotalPages et PagesComplete pour suivre le nombre total de pages en cours de traitement et le nombre de pages entièrement traitées.

Quel est un exemple pratique d'utilisation du suivi de progression dans l'OCR ?

Un exemple pratique implique de s'abonner à l'événement OcrProgress lors du traitement d'un document d'exemple intitulé 'Expériences en Recherche sur la Biodiversité : Un Cours de Terrain.' Cela démontre le suivi de la progression, de la durée et de l'état de réalisation dans IronOCR.

Chaknith Bin
Ingénieur logiciel
Chaknith travaille sur IronXL et IronBarcode. Il a une expertise approfondie en C# et .NET, aidant à améliorer le logiciel et à soutenir les clients. Ses idées issues des interactions avec les utilisateurs contribuent à de meilleurs produits, documentation et expérience globale.
Prêt à commencer?
Nuget Téléchargements 5,167,857 | Version: 2025.11 vient de sortir