C#で複数の BarCode を一度に読み取る方法

Updated: 2026年6月4日

IronBarcodeを使用すると、複数のバーコードを期待 = true を設定することで、画像やPDFから複数のバーコードを同時に読み取ることができ、物流、小売、在庫管理アプリケーションのデータ処理を効率化します。倉庫システム、小売POSアプリケーション、または文書処理ソリューションの構築のいずれにおいても、IronBarcodeの高度な読み取り機能は、必要な信頼性とパフォーマンスを提供します。

クイックスタート: 簡単に画像からすべてのバーコードを読み取る

この例では、IronBarcodeを使用することで、バーコードが含まれる画像をすばやくスキャンできることを示しています。ただし、複数のバーコードを期待 = true を必要なバーコード型と一緒に設定するだけで、ボイラープレートも手間もありません。

1Install IronBarcode with NuGet Package Manager
PM > Install-Package BarCode
```
Install-Package BarCode
```

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

var results = IronBarCode.BarcodeReader.Read("image.png", new IronBarCode.BarcodeReaderOptions { 複数のバーコードを期待 = true, ExpectBarcodeTypes = IronBarCode.BarcodeEncoding.AllOneDimensional });

var results = IronBarCode.BarcodeReader.Read("image.png", new IronBarCode.BarcodeReaderOptions { 複数のバーコードを期待 = true, ExpectBarcodeTypes = IronBarCode.BarcodeEncoding.AllOneDimensional });

3実際の環境でテストするためにデプロイする

今日プロジェクトで IronBarcode を使い始めましょう無料トライアル

最小限のワークフロー（5ステップ）

複数のバーコードを読み取るためのC#ライブラリをダウンロードする
Readメソッドを使用して、さまざまな画像形式からバーコード値を抽出します。
ExpectMultipleBarcodesプロパティを使用して、単一または複数のバーコードの読み取りを設定します。
パフォーマンスを向上させるには、ExpectMultipleBarcodes プロパティを false に設定します。
バーコードの値を印刷

画像から複数の BarCode を読み取るにはどうすればよいですか?

デフォルトでは、IronBarcodeはドキュメントを連続してスキャンし、複数のバーコードを読み取ります。しかし、複数の BarCode が存在する場合でも、1 つの BarCode 値しか返されない場合があります。これに対処するには、以下のように、複数の BarCode を読み取れるように設定をカスタマイズします。このExpectMultipleBarcodes プロパティは、BarcodeReaderOptions クラスとPdfBarcodeReaderOptions クラスの両方に存在するため、画像やPDF文書のバーコードを読み取るために使用できます。

A、B、C とラベル付けされた 3 つのサンプル BarCode は、マルチバーコード読み取りデモ用の異なるバーパターンを示しています。

using IronBarCode;
using System;

// Set the option to read multiple barcodes
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional,
};

// Read barcode
var results = BarcodeReader.Read("testbc1.png", options);

foreach (var result in results)
{
    Console.WriteLine(result.ToString());
}

using IronBarCode;
using System;

// Set the option to read multiple barcodes
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional,
};

// Read barcode
var results = BarcodeReader.Read("testbc1.png", options);

foreach (var result in results)
{
    Console.WriteLine(result.ToString());
}

Imports IronBarCode
Imports System

' Set the option to read multiple barcodes
Private options As New BarcodeReaderOptions() With {
	.ExpectMultipleBarcodes = True,
	.ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional
}

' Read barcode
Private results = BarcodeReader.Read("testbc1.png", options)

For Each result In results
	Console.WriteLine(result.ToString())
Next result

Imports IronBarCode
Imports System

' Set the option to read multiple barcodes
Private options As New BarcodeReaderOptions() With {
	.ExpectMultipleBarcodes = True,
	.ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional
}

' Read barcode
Private results = BarcodeReader.Read("testbc1.png", options)

For Each result In results
	Console.WriteLine(result.ToString())
Next result

BarcodeResults変数に保存できます。 foreachループを使用して、すべてのバーコードの値に簡単にアクセスし、コンソールに出力できます。

高度な複数の BarCode 読み取りシナリオ

複数の BarCode を扱う場合、追加設定が必要なシナリオに遭遇する可能性があります。以下は、複雑な文書から異なるフォーマットの複数の BarCode を読み取る方法を示す包括的な例です：

using IronBarCode;
using System;
using System.Linq;

// Configure advanced options for mixed barcode types
BarcodeReaderOptions advancedOptions = new BarcodeReaderOptions()
{
    ExpectMultipleBarcodes = true,
    // Read both 1D and 2D barcodes
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional | BarcodeEncoding.QRCode | BarcodeEncoding.DataMatrix,
    // Apply image correction filters for better accuracy
    ImageFilters = new ImageFilterCollection() {
        new SharpenFilter(),
        new ContrastFilter()
    },
    // Set speed vs accuracy balance
    Speed = ReadingSpeed.Balanced
};

// Read barcodes from the image
var imageResults = BarcodeReader.Read("mixed-barcodes.jpg", advancedOptions);

// Process results with error handling
foreach (var result in imageResults)
{
    Console.WriteLine($"Barcode Type: {result.BarcodeType}");
    Console.WriteLine($"Value: {result.Value}");
    Console.WriteLine($"Page: {result.PageNumber}");
    Console.WriteLine("---");
}

using IronBarCode;
using System;
using System.Linq;

// Configure advanced options for mixed barcode types
BarcodeReaderOptions advancedOptions = new BarcodeReaderOptions()
{
    ExpectMultipleBarcodes = true,
    // Read both 1D and 2D barcodes
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional | BarcodeEncoding.QRCode | BarcodeEncoding.DataMatrix,
    // Apply image correction filters for better accuracy
    ImageFilters = new ImageFilterCollection() {
        new SharpenFilter(),
        new ContrastFilter()
    },
    // Set speed vs accuracy balance
    Speed = ReadingSpeed.Balanced
};

// Read barcodes from the image
var imageResults = BarcodeReader.Read("mixed-barcodes.jpg", advancedOptions);

// Process results with error handling
foreach (var result in imageResults)
{
    Console.WriteLine($"Barcode Type: {result.BarcodeType}");
    Console.WriteLine($"Value: {result.Value}");
    Console.WriteLine($"Page: {result.PageNumber}");
    Console.WriteLine("---");
}

この高度な例では、いくつかの重要な機能を紹介します：

混合バーコード形式のサポート：異なるバーコードエンコーディングタイプを組み合わせます。
画像補正フィルター：画像フィルタを使用して読み取り精度を向上させます。
読書速度の最適化: 読書速度オプションで速度と正確さのバランスをとる。
信頼度スコア：検出された各バーコードの信頼度しきい値にアクセスします。

パフォーマンスを向上させるために単一の BarCode を読み取るにはどうすればよいですか?

IronBarcodeは画像やPDFのシングルバーコード、マルチバーコードを読み取ります。デフォルトでは、バーコードが1つしかない場合でも、エンジンはドキュメント全体をスキャンします。単一バーコードを読み取る際のパフォーマンスを向上させるには、ExpectMultipleBarcodesをfalseに設定してください。これにより、最初の BarCode を検出した後、エンジンが文書全体をスキャンすることがなくなり、バーコードの検索が高速化されます。以下のコードは、このアプローチを示しています。

バーコード読み取りデモ用に、A、B、C とラベル付けされた 3 つの同じサンプルバーコード。

using IronBarCode;
using System;

// Set the option to read single barcode
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    ExpectMultipleBarcodes = false,
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional,
};

// Read barcode
var results = BarcodeReader.Read("testbc1.png", options);

foreach (var result in results)
{
    Console.WriteLine(result.ToString());
}

using IronBarCode;
using System;

// Set the option to read single barcode
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    ExpectMultipleBarcodes = false,
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional,
};

// Read barcode
var results = BarcodeReader.Read("testbc1.png", options);

foreach (var result in results)
{
    Console.WriteLine(result.ToString());
}

Imports IronBarCode
Imports System

' Set the option to read single barcode
Private options As New BarcodeReaderOptions() With {
	.ExpectMultipleBarcodes = False,
	.ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional
}

' Read barcode
Private results = BarcodeReader.Read("testbc1.png", options)

For Each result In results
	Console.WriteLine(result.ToString())
Next result

Imports IronBarCode
Imports System

' Set the option to read single barcode
Private options As New BarcodeReaderOptions() With {
	.ExpectMultipleBarcodes = False,
	.ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional
}

' Read barcode
Private results = BarcodeReader.Read("testbc1.png", options)

For Each result In results
	Console.WriteLine(result.ToString())
Next result

この例では、以前と同じ複数のバーコード付きの画像を使用しましたが、ExpectMultipleBarcodesをfalseに設定しました。その結果、最初のバーコード値のみが返され、スキャンプロセスは最初のバーコードが取得されると停止します。

クロップ領域による単一 BarCode 読み取りの最適化

単一バーコードを読み取る際のパフォーマンスをさらに向上させるには、複数のバーコードを期待 = false設定をクロップ領域の指定と組み合わせてください。このテクニックは、バーコードのおおよその位置がわかっている場合に特に役立ちます：

using IronBarCode;
using IronSoftware.Drawing;

// Define a crop region where the barcode is likely located
var cropRegion = new Rectangle(100, 100, 300, 200);

// Configure options for optimal single barcode reading
BarcodeReaderOptions optimizedOptions = new BarcodeReaderOptions()
{
    ExpectMultipleBarcodes = false,
    ExpectBarcodeTypes = BarcodeEncoding.Code128,
    CropArea = cropRegion,
    Speed = ReadingSpeed.Faster
};

// Read with optimized settings
var result = BarcodeReader.Read("product-label.png", optimizedOptions).FirstOrDefault();

if (result != null)
{
    Console.WriteLine($"Barcode found: {result.Value}");
}

using IronBarCode;
using IronSoftware.Drawing;

// Define a crop region where the barcode is likely located
var cropRegion = new Rectangle(100, 100, 300, 200);

// Configure options for optimal single barcode reading
BarcodeReaderOptions optimizedOptions = new BarcodeReaderOptions()
{
    ExpectMultipleBarcodes = false,
    ExpectBarcodeTypes = BarcodeEncoding.Code128,
    CropArea = cropRegion,
    Speed = ReadingSpeed.Faster
};

// Read with optimized settings
var result = BarcodeReader.Read("product-label.png", optimizedOptions).FirstOrDefault();

if (result != null)
{
    Console.WriteLine($"Barcode found: {result.Value}");
}

シングルバーコード読み取りはどれくらい速いですか?

複数のバーコードを期待 = falseを設定すると、単一バーコードを読み取る効率が大幅に向上します。パフォーマンスの向上は、高解像度の画像を扱う場合や、高スループットのアプリケーションで非同期バーコード読み取りを実装する場合に特に顕著です。

提供されたコードスニペットを使用して、複数のバーコードを期待 = trueを設定した場合とfalseに設定した場合の同じマシンでのパフォーマンス差の概算が示されています。

複数のバーコードを期待 = true	複数のバーコードを期待 = false
00.91秒	00.10秒

これは、単一の BarCode を読み取る際に、約 9 倍のパフォーマンス向上を意味します。実際のパフォーマンスは、以下の条件によって異なります：

画像の解像度と複雑さ
画像に含まれる BarCode の数
選択されたバーコード形式
応用画像フィルタ
ハードウェア仕様

複数の BarCode を読み取るためのベストプラクティス

本番アプリケーションで複数の BarCode 読み取りを実装する場合は、以下のベストプラクティスを考慮してください：

期待されるバーコードタイプを指定: BarcodeEncoding.Allを使用する代わりに、期待するフォーマットのみを指定します。これにより、パフォーマンスが大幅に向上します。

2.適切な画像形式を使用する：最良の結果を得るためには、コントラストの高い画像を使用してください。最適な BarCode 画像の作成については、こちらをご覧ください。

3.不完全なBarCodeを扱う：実世界のBarCodeは破損していたり、印刷が不完全だったりすることがあります。画像修正技術を使用して、読解の成功率を高めます。

4.ストリーム処理：大きなバッチでは、ストリームからの読み取りを検討して、メモリ使用量を最適化します。

5.エラー処理：BarCodeが読み取れないシナリオに対しては、常に適切なエラー処理を実装してください：

try
{
    var results = BarcodeReader.Read("barcodes.png", new BarcodeReaderOptions 
    { 
        ExpectMultipleBarcodes = true 
    });
    
    if (!results.Any())
    {
        Console.WriteLine("No barcodes found in the image");
    }
    else
    {
        Console.WriteLine($"Found {results.Count()} barcodes");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Error reading barcodes: {ex.Message}");
    // Log error for debugging
}

try
{
    var results = BarcodeReader.Read("barcodes.png", new BarcodeReaderOptions 
    { 
        ExpectMultipleBarcodes = true 
    });
    
    if (!results.Any())
    {
        Console.WriteLine("No barcodes found in the image");
    }
    else
    {
        Console.WriteLine($"Found {results.Count()} barcodes");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Error reading barcodes: {ex.Message}");
    // Log error for debugging
}

Try
    Dim results = BarcodeReader.Read("barcodes.png", New BarcodeReaderOptions With {
        .ExpectMultipleBarcodes = True
    })

    If Not results.Any() Then
        Console.WriteLine("No barcodes found in the image")
    Else
        Console.WriteLine($"Found {results.Count()} barcodes")
    End If
Catch ex As Exception
    Console.WriteLine($"Error reading barcodes: {ex.Message}")
    ' Log error for debugging
End Try

Try
    Dim results = BarcodeReader.Read("barcodes.png", New BarcodeReaderOptions With {
        .ExpectMultipleBarcodes = True
    })

    If Not results.Any() Then
        Console.WriteLine("No barcodes found in the image")
    Else
        Console.WriteLine($"Found {results.Count()} barcodes")
    End If
Catch ex As Exception
    Console.WriteLine($"Error reading barcodes: {ex.Message}")
    ' Log error for debugging
End Try

これらのプラクティスに従い、IronBarcodeの包括的な機能を活用することで、様々な業界やユースケースにおける複数のバーコード読み取りシナリオを効率的に処理する堅牢なアプリケーションを構築することができます。

よくある質問

C# で 1 つの画像から複数の BarCode を読み取る方法を教えてください。

IronBarcodeでは、BarcodeReaderOptionsでExpectMultipleBarcodes = trueを設定することで、1つの画像から複数のバーコードを読み取ることができます。これにより、IronBarcodeはドキュメント全体をスキャンし、見つかったすべてのバーコードをBarCodeResultsコレクションとして返すことができます。

画像内のすべての BarCode をスキャンする最速の方法は？

最速のアプローチはIronBarcodeのReadメソッドをExpectMultipleBarcodes = trueで使用することです: var results = IronBarCode.BarcodeReader.Read("image.png", new IronBarCode.BarcodeReaderOptions { ExpectMultipleBarcodes = true }).この最小限のコードは複雑な設定なしにすべてのバーコード値を抽出します。

画像だけでなく、PDF文書から複数のBarCodeを読み取ることはできますか？

はい、IronBarcodeは画像とPDFドキュメントの両方から複数のバーコードを読み取ることをサポートしています。ExpectMultipleBarcodesプロパティはBarCodeReaderOptionsとPdfBarcodeReaderOptionsの両クラスで利用可能で、任意のドキュメントタイプに対して複数のバーコード読み取りを設定することができます。

ExpectMultipleBarcodes を true に設定しないとどうなりますか？

デフォルトでは、IronBarcodeは複数のバーコードについてドキュメントを継続的にスキャンします。しかし、場合によっては複数のバーコードが存在しても1つのバーコード値しか返されないことがあります。ExpectMultipleBarcodes = trueを明示的に設定することで、IronBarcodeはドキュメント内のすべてのバーコードをスキャンして返します。

複数の BarCode を読み取った後、個々の BarCode 値にアクセスするにはどうすればよいですか？

IronBarcodeで複数のバーコードを読み取った後、結果はBarCodeResults変数に格納されます。foreachループを使ってコレクションを繰り返し、各バーコードの値、テキスト、フォーマットのプロパティを処理することで、個々のバーコードの値に簡単にアクセスできます。

複数の BarCode を読み取ることは、小売や物流のアプリケーションに適していますか？

IronBarcodeの複数バーコード読み取り機能は、小売POSシステム、倉庫管理、物流追跡、在庫管理アプリケーションに最適です。出荷ラベル、製品カタログ、在庫シートのすべてのバーコードを同時に効率的にスキャンすることで、データ処理を合理化します。

複数のバーコードを読み取る際に、どのバーコードタイプを検索するかを指定できますか？

はい、IronBarcodeではExpectBarcodeTypesプロパティを使って予想されるバーコードタイプを指定することができます。スキャンのパフォーマンスを最適化するために、AllOneDimensional、QRCode、またはサポートされているバーコードタイプの任意の組み合わせのような特定のフォーマットをスキャンするように設定できます。

ExpectMultipleBarcodes の設定はスキャンのパフォーマンスに影響しますか？

ExpectMultipleBarcodes = falseを設定すると、ドキュメントにバーコードが1つしか存在しないことが分かっている場合にパフォーマンスを向上させることができます。IronBarcodeは最初のバーコードを見つけるとスキャンを停止し、シングルバーコードシナリオの高速化を実現すると同時に、必要に応じてマルチバーコードの読み取りにも柔軟に対応します。

Is stream processing supported in IronBarcode for large barcode batches?

Yes, IronBarcode supports reading barcodes from streams, which is particularly useful for optimizing memory usage in high-throughput applications or large batch processing.