C# での OcrProgress トラッキングの使用方法

IronOCR を使って C# で進捗状況を追跡する方法

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

IronOCR は、OCR (光学文字認識) 読み取り操作の進行状況を追跡するためにサブスクライブするイベントを提供します。 これらのプロパティは、OCR ジョブの進行状況、期間、完了ステータスに関する貴重な情報を提供するため、アプリケーションは OCR プロセスを効果的に監視およびレポートできます。

クイックスタート: OcrProgress を購読して PDF を読む

この例では、IronOCR を使用して OCR の進行状況を簡単に監視できる方法を示します。組み込みのOcrProgressイベントをサブスクライブし、PDF の読み取り中に即座にフィードバック (パーセンテージ、完了ページ数、合計ページ数) を取得します。 始めるには数行必要です。

Nuget Icon今すぐ NuGet で PDF を作成してみましょう:

  1. NuGet パッケージ マネージャーを使用して IronOCR をインストールします

    PM > Install-Package IronOcr

  2. このコード スニペットをコピーして実行します。

    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. 実際の環境でテストするためにデプロイする

    今すぐ無料トライアルでプロジェクトに IronOCR を使い始めましょう
    arrow pointer


進捗状況追跡の例

OcrProgressイベントをサブスクライブすると、読み取りプロセスの進行状況の更新を受信できます。 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. アイオワ州立大学のゲスラー氏。

: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
進捗状況の更新

イベントからの情報

  • ProgressPercent : OCR ジョブの進行状況を、完了したページの割合として表します。 範囲は0~100です。
  • TotalPages : OCR エンジンによって処理されているページの合計数を示します。
  • PagesComplete : OCR 読み取りが完全に完了したページ数を指定します。 この数は、ページが処理されるにつれて徐々に増加する可能性があります。
  • Duration : OCR ジョブの合計期間を表し、プロセス全体が完了するまでにかかった時間を示します。 TimeSpan 形式で測定されます。 この時間はイベントがトリガーされるたびに更新されます。
  • StartTimeUTC : OCR ジョブが開始された日時を協定世界時 (UTC) 形式で示します。
  • EndTimeUTC : OCR ジョブが UTC 形式で 100% 完了した日時を表します。 このプロパティは、OCR が進行中は null で、OCR プロセスが終了すると設定されます。

よくある質問

C#でOCRジョブの進捗をどのように追跡できますか?

C#でOCRジョブの進捗を追跡するには、IronOCRのOcrProgressイベントに登録します。このイベントは進捗状況、時間、および処理されたページ数に関する更新を提供します。

OCR操作におけるOcrProgressイベントの役割は何ですか?

IronOCRのOcrProgressイベントは、開発者がOCRジョブの進行状況、合計所要時間、開始時刻と終了時刻、処理中の合計ページ数を含むリアルタイム更新を受け取ることを可能にします。

ProgressPercentプロパティは何を提供しますか?

IronOCRのProgressPercentプロパティは、OCRジョブの進捗をパーセンテージで示し、タスクがどれほど完了しているかを0から100までの範囲で明確に示します。

OCRプロセスの総所要時間をどのように取得しますか?

IronOCRのDurationプロパティにアクセスすることで、OCRプロセスの総所要時間を取得できます。このプロパティは、OcrProgressイベントがトリガーされるたびに更新され、プロセス全体にかかった時間を反映します。

OCRジョブの開始と終了を判断できますか?

はい、IronOCRはStartTimeUTCEndTimeUTCプロパティを提供しており、これによりOCRジョブの開始時間と完了時間をそれぞれUTC形式で示します。

OCR処理中に複数のページをどのように扱うことができますか?

IronOCRでは、TotalPagesPagesCompleteプロパティを使用して処理されている総ページ数と完全に処理されたページ数を追跡することで、複数のページを扱うことができます。

OCRにおける進捗追跡の実用例とは何ですか?

実用例には、『生物多様性研究の体験:フィールドコース』というタイトルのサンプルドキュメントを処理中にOcrProgressイベントに登録することが含まれます。この例は、IronOCRにおける進捗、所要時間、および完了状況の追跡を示しています。

Chaknith Bin
ソフトウェアエンジニア
ChaknithはIronXLとIronBarcodeに取り組んでいます。彼はC#と.NETの深い専門知識を持ち、ソフトウェアの改善や顧客サポートに貢献しています。ユーザーとの対話から得られる洞察が、より良い製品、ドキュメント、および全体的な経験に寄与しています。
準備はできましたか?
Nuget ダウンロード 5,167,857 | Version: 2025.11 リリース