C#でIronBarcodeを使用して非同期とマルチスレッドを使う方法
IronBarcodeの非同期処理とマルチスレッド処理では、バーコード読み取り性能の最適化が異なります。非同期処理ではI/O処理中にメインスレッドがブロックされるのを防ぎ、マルチスレッド処理ではCPUコア間で複数のバーコードを同時に処理します。
開発者はしばしばAsyncとMultithreadingの操作を混同します。 どちらの手法も、システムリソースの利用を最適化し、実行時間を短縮することで、プログラムのパフォーマンスと効率を高めます。しかし、アプローチ、メカニズム、使用例が異なります。 IronBarcodeは両方のアプローチをサポートしています。 この記事では、IronBarcodeを使用したそれぞれの違いや実装について説明します。
このワンラインの例を使用して、即座にIronBarcodeで開始できます。 非同期読み取りとマルチスレッドオプションを組み合わせて、最小限の設定で複数のバーコード画像を並行してスキャンする方法を示しています。
-
1IronBarcode を NuGet Package Manager でインストールします
-
2このコード スニペットをコピーして実行します。
var results = await IronBarCode.BarcodeReader.ReadAsync(imagePaths, new IronBarCode.BarcodeReaderOptions { Multithreaded = true, MaxParallelThreads = 4, ExpectMultipleBarcodes = true });Dim results = Await IronBarCode.BarcodeReader.ReadAsync(imagePaths, New IronBarCode.BarcodeReaderOptions With {.Multithreaded = True, .MaxParallelThreads = 4, .ExpectMultipleBarcodes = True})Dim results = Await IronBarCode.BarcodeReader.ReadAsync(imagePaths, New IronBarCode.BarcodeReaderOptions With {.Multithreaded = True, .MaxParallelThreads = 4, .ExpectMultipleBarcodes = True}) -
3実際の環境でテストするためにデプロイする
今日からご自身のプロジェクトでIronBarcodeを使い始めるには、無料トライアルをお試しください。
最小限のワークフロー(5ステップ)
- 非同期およびマルチスレッドサポートのためのC#ライブラリをダウンロード
- 非同期バーコード読み取りのために、
ReadAsyncおよびReadPdfsAsyncメソッドを使用します。 - Multithreadedプロパティを 'true' に設定してマルチスレッドを有効にします。
- MaxParallelThreadsプロパティを使用して並列スレッド数を指定します
- 通常、非同期、マルチスレッドのバーコード読み取りのパフォーマンス比較を確認する
IronBarcodeを使用してバーコードを非同期に読み取るにはどうすればよいですか?
非同期読み取りにより、長時間またはブロッキング操作がメインスレッドの実行をブロックせずに進行できるようになります。 C#では、非同期機能をサポートするメソッドに対してasyncとawaitキーワードを使用します。 このアプローチは、追加のスレッドを作成するのではなく、現在のスレッドを解放します。 メインスレッドはタスクを開始し管理しますが、1つのタスクだけに専念するわけではありません。 非同期メソッドが関与を要求するときにメインスレッドが戻り、必要ないときに他のタスクを処理できるようになります。これは、ファイルの読み書きやネットワークリクエストなどのI/Oに依存するタスクに特に有用です。
バーコードの読み取りを例に考えてみましょう。 プロセスには以下が含まれます:
- ファイルの読み取り
- 読み取りオプションの適用
- バーコードのデコード
ファイル読み取り中に、メインタスクが解放されることがあります。 これは、複数の画像ファイルや大規模なPDFがあるシナリオで役立ちます。このことは、当社のバーコードを読む方法チュートリアルで示されています。
画像とPDF文書にそれぞれバーコードを非同期で読み取るには、ReadAsyncとReadPdfsAsyncメソッドを使用します。 非同期操作を実装する前に、プロジェクトにIronBarcodeをNuGet経由でインストールしたことを確認してください。
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());
}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 resultImports 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上記のコードスニペットは、IronBarcodeによって非同期に読み取られる画像パスのListをインスタンス化します。 画像を読み取るには、BarcodeReaderクラスからReadAsyncメソッドを使用します。 imagePathsと読み取りオプションを指定します。 高度な構成オプションについては、バーコードリーダー設定ガイドを参照してください。
この非同期操作方法は、同じクラスのReadPdfsAsyncを通じてPDFドキュメントのバーコードを読み取るためにも利用可能です。 特定のPDF読み取り構成については、PDFバーコードリーダー設定ガイドをご覧ください。
Multithreaded
MaxParallelThreads
通常のメソッドよりも非同期読み取りを使用するのはいつですか?
非同期読み上げは、いくつかのシナリオで優れています:
- GUIアプリケーション: UIの応答性を必要とするWindows FormsまたはWPFアプリケーション。 Asyncは、バーコードスキャン中のインターフェイスのフリーズを防ぎます。
- Webアプリケーション: スレッドをブロックせず、同時に複数のリクエストを処理するASP.NETアプリケーション。特にアップロードされたバーコード画像を処理する場合。
- バッチ処理: 複数のバーコード画像やPDFを順番に読み取ることで、I/O操作中に他のタスクの実行を可能にします。
- ネットワーク操作: 遠隔地やURLからバーコードを読み取る。当社のURLから非同期でバーコードを読む例に示されています。
非同期読み取りがアプリケーションの応答性を向上させるのはなぜですか?
非同期読み取りは、I/Oバウンド操作中にメインスレッドを解放することによって応答性を向上させます。 IronBarcodeがディスクからイメージファイルを読み込んだり、PDFを処理するとき、スレッドはアイドル待機しません。 その代わり、ユーザー入力への応答やリクエストの処理など、その他のタスクを処理します。 これは、特に次のような場合に顕著です:
- 読み込みに時間がかかる大きな画像ファイル
- バーコードを含む複数ページのPDF
- ネットワークベースの画像ソース
- バーコード検出前に画像補正フィルターが必要なシナリオ
非同期バーコード読み取りを使用する際の一般的な落とし穴は何ですか?
非同期の BarCode 読み取りを実装する場合は、以下の一般的な問題に注意してください:
- デッドロック: UIコンテキストで非同期メソッドに
ResultやWait()を避けてください。 呼び出しチェーン全体でawaitを常に使用してください。 - 例外処理: 非同期メソッドの例外が期待どおりに伝播しない場合があるので、非同期呼び出しをtry-catchブロックでラップします。
- コンテキストスイッチング: 元の同期コンテキストに戻る必要がない場合は
ConfigureAwait(false)の使用を検討してください。 - パフォーマンスの誤解: 非同期は個々の操作を加速しません; アプリケーションの応答性が向上します。 複数の画像によるスピードアップのために、マルチスレッドを検討してください。
非同期関連の問題のトラブルシューティングについては、当社のバーコード認識トラブルシューティングガイドを参照してください。
マルチスレッドバーコード読み取りを有効にする方法は?
非同期操作とは異なり、マルチスレッドは、複数のスレッドにまたがって単一のプロセスを同時に実行します。 マルチスレッドは、単一のスレッドで逐次実行する代わりに、タスクを複数のスレッドに分割して同時実行します。 マルチスレッドには複数のCPUコアが必要で、これらのコアは独立してスレッドを実行します。 非同期操作と同様に、マルチスレッドはアプリケーションのパフォーマンスと応答性を向上させます。
IronBarcodeでは、BarcodeReaderOptionsにてMultithreadedプロパティを設定し、MaxParallelThreadsを使用して同時実行のための最大コア数を指定することでマルチスレッド化を有効にします。 デフォルトのMaxParallelThreads値は4で、利用可能なCPUコアに基づいて調整可能です。 最適なパフォーマンス構成については、当社の読み取り速度オプションガイドを参照してください。
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());
}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 resultImports 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どれくらいのパフォーマンス向上が期待できますか?
2つのサンプル画像を読み取り、通常操作、非同期操作、マルチスレッド操作の読み取り時間を比較してみましょう。
サンプル画像


| 通常の読み取り | 非同期読み取り | マルチスレッド読み取り(4コア) |
|---|---|---|
| 01.75秒 | 01.67秒 | 01.17秒 |
比較では非同期およびマルチスレッド読み取りでのパフォーマンス向上が示されています。 この例示的な例では、マルチスレッドは通常の読み取りに対して注目すべき改善を提供し、非同期は小さな改善を提供します; 実際の結果はハードウェア、データセット、およびIronBarcodeのバージョンによって異なります。 しかし、これらの業務は、目的やアプローチが異なります。 アプリケーションの要件に最も適したアプローチを選択してください。
パフォーマンスの向上は、以下によって異なります:
- 処理画像数
- 画像の複雑さとバーコードの品質
- 使用可能なCPUコア
- その他のシステムリソース
単一のドキュメントに複数のバーコードがある状況については、複数のバーコードを読むガイドをご覧ください。
非同期操作よりもマルチスレッドを選択するのはいつですか?
マルチスレッドを選択する場合
- CPU使用が高い操作: 複雑な画像フィルターや高解像度画像のような重い計算を含む処理。
- バッチ処理: 同時に処理が必要な複数の独立した画像。
- マルチコアシステム: 配置環境に複数のCPUコアが利用可能。
- パフォーマンス優先: 生の処理速度が資源効率性よりも重要。
非同期処理を選択するのは、次のような場合です:
- I/O依存の操作: 大半の時間はファイルの読み取りやネットワークの応答待ちに費やされる。
- UIアプリケーション: 応答性のあるユーザーインターフェイスの維持が重要。
- 限られたリソース: CPUコアが限られたシステムでの実行。
- Webアプリケーション: 効率的に複数の並行リクエストを処理する。
最適なMaxParallelThreads値を決定する方法は?
最適なMaxParallelThreads値は複数の要因に依存します:
- 利用可能なCPUコア: 基準として
Environment.ProcessorCountから始める。 - 作業負荷の種類: 純粋なバーコード読み取りには利用可能コアの75%を使用。
- システムリソース: OSや他のプロセスのために余裕を残す。
- テスト結果: 特定の作業負荷でベンチマークを行う。
最適な値を見つけるための実践的なアプローチをご紹介します:
int optimalThreads = Math.Max(1, Environment.ProcessorCount - 1);int optimalThreads = Math.Max(1, Environment.ProcessorCount - 1);netnet本番環境では、パフォーマンスを監視し、実際の使用パターンに基づいて調整します。 企業向けの最大パフォーマンスが必要な展開には、ライセンスキー設定を実装することを検討してください。
完全なAPI機能については、IronBarcode APIリファレンスを参照してください。
よくある質問
C#における非同期バーコード読み取りとは何ですか?
IronBarcodeを使用したC#での非同期バーコード読み取りは、I/O操作中にメインスレッドをブロックせずにバーコードスキャンを進めることができます。これは、ファイル読み取りやネットワークリクエストを伴う操作において有用です。IronBarcodeの'ReadAsync'などのメソッドは、'async'と'await'キーワードを使用してこれを実現します。
IronBarcodeにおけるマルチスレッド処理は、どのようにバーコードの読み取り性能を向上させますか?
マルチスレッド処理は、複数のスレッドを使用してCPUコア間で画像を同時に処理することによってバーコード読み取りの性能を向上させます。IronBarcodeでは、この機能は'Multithreaded'プロパティを設定し、'BarcodeReaderOptions'で'MaxParallelThreads'を指定することで有効になります。
IronBarcodeでのバーコード読み取りに非同期処理とマルチスレッドを併用できますか?
はい、IronBarcodeは非同期読み取りとマルチスレッド処理の組み合わせをサポートしています。これにより、非ブロッキングI/Oのためのasync/awaitと並列処理のためのマルチスレッドを活用して、複数のバーコード画像の効率的な処理が可能になります。
どのような場合に非同期バーコード読み取りを、マルチスレッド操作より優先するべきですか?
非同期読み取りは、主にI/O操作が多いシナリオ、例えばファイルの読み取りやネットワークリクエストの管理が必要な場合に優先されるべきです。特に、GUIやウェブアプリケーションのように応答性を維持することが重要なアプリケーションにおいても有益です。
非同期バーコード読み取りを使用する際の一般的な落とし穴は何ですか?
一般的な落とし穴には、'await'の代わりに'Result'や'Wait'を使用することによるデッドロック、例外処理の不足、不必要なコンテキストスイッチ、個々の操作を非同期によって迅速化できるという誤解があります。
IronBarcodeでの最適な'MaxParallelThreads'設定に影響を与える要因は何ですか?
最適な'MaxParallelThreads'の値は、利用可能なCPUコア数、作業負荷の種類、システム全体のリソース、およびテスト結果によって影響を受けます。実際的な出発点として、利用可能なCPUコア数より1つ少ない値を使用することが推奨されます。
IronBarcodeの非同期機能はどのようにアプリケーションの応答性を向上させますか?
IronBarcodeの非同期機能は、長時間のI/Oバウンドなバーコード読み取り作業中にメインスレッドを開放することでアプリケーションの応答性を向上させ、ユーザーインターフェースの更新など他のプロセスを同時に処理できるようにします。
バーコード読み取りにおけるマルチスレッドのメリットは何ですか?
マルチスレッドは、複数の画像を同時に処理することができるため、複雑な画像フィルター処理や高解像度画像の処理など、CPUバウンドな操作において性能を向上させます。これは、複数のCPUコアを持つ環境で有益です。
IronBarcodeで最適な性能を発揮するためのライセンスキー設定の実装方法は?
最大の性能が求められる企業向けデプロイメントでは、ライセンスキー設定の実装を検討してください。IronBarcodeのライセンスキー設定に関するドキュメントに従うことで、機能を完全に解放し、リソースの最適化を実現します。
IronBarcodeにおける非同期とマルチスレッドの主な違いは何ですか?
IronBarcodeにおける非同期処理は、I/O操作中にメインスレッドがブロックされるのを防ぎ、ファイルやネットワークタスクに最適です。一方、マルチスレッドは、タスクをスレッド間で分割し、CPUコアでの並行実行により性能を向上させ、CPUバウンドな操作に役立ちます。