1. IronOCR
  2. Guides pratiques
  3. Suivi de Progression
Comment utiliser le suivi OcrProgress en C#

How to Use Progress Tracking

Chaknith Bin
Chaknith Bin
Mis à jour:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronOcr fournit 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 la progression, la durée et l'état d'achèvement du travail d'OCR, ce qui permet aux applications de surveiller efficacement le processus d'OCR et d'en rendre compte.

Quickstart : Subscribe to OcrProgress and Read PDF

Cet exemple montre comment vous pouvez suivre sans effort la progression de l'OCR avec IronOcr : abonnez-vous à son événement intégré OcrProgress et obtenez un retour d'information instantané (pourcentage, pages effectuées, nombre total de pages) pendant la lecture d'un PDF. Il s'agit de quelques lignes pour commencer.

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronOCR with NuGet Package Manager

    PM > Install-Package IronOcr

  2. Copy and run this code snippet.

    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. Deploy to test on your live environment

    Start using IronOCR in your project today with a free trial
    arrow pointer

Flux de travail minimal (5 étapes)

  1. Téléchargez une bibliothèque C# pour suivre la progression de la lecture
  2. Souscrire à l'événement OcrProgress
  3. Utiliser l'instance transmise par l'événement pour récupérer les informations sur la progression
  4. Obtenir la progression en pourcentage et en durée totale
  5. Récupérer les heures de début et de fin, ainsi que le nombre total de pages


Exemple de suivi de progression

L'événement OcrProgress peut être souscrit pour recevoir des mises à jour sur la progression 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
Progress update

Information sur l'événement

  • ProgressPercent : Représente l'état d'avancement du travail d'OCR en pourcentage de pages terminées. L'échelle va de 0 à 100.
  • TotalPages : indique le nombre total de pages traitées par le moteur OCR.
  • PagesComplete : Spécifie le nombre de pages pour lesquelles la lecture OCR a été entièrement achevée. Ce nombre peut augmenter progressivement au fur et à mesure que les pages sont traitées.
  • Durée : Représente la durée totale du travail d'OCR, indiquant le temps nécessaire à la réalisation de l'ensemble du processus. Elle est mesurée au format TimeSpan. Cette heure est mise à jour à chaque fois que l'événement est déclenché.
  • StartTimeUTC : Indique la date et l'heure de début du travail d'OCR, représentées au format UTC (Coordinated Universal Time).
  • EndTimeUTC : Représente la date et l'heure auxquelles le travail d'OCR a été achevé à 100 % au format UTC. Cette propriété est nulle lorsque l'OCR est encore en cours et se remplit une fois le processus d'OCR 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
Chaknith Bin
  Discutez maintenant avec l'équipe d'ingénierie
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,044,537 | Version : 2025.11 vient de sortir