如何在 C# 中一次讀取多個 BarCode；

IronBarcode 可透過設定 ExpectMultipleBarcodes = true 從影像和 PDF 中同時讀取多個條碼，簡化物流、零售和庫存管理應用程式的資料處理。 無論是建立倉儲系統、零售點銷售應用程式或文件處理解決方案，IronBarcode先進的讀取功能都能提供您所需的可靠性和效能。

快速入門：輕鬆讀取影像中的所有條碼

本範例展示如何快速使用 IronBarcode 掃描影像，以獲得其中包含的每個條碼。 只需在您想要的 BarCode 類型旁邊設定 ExpectMultipleBarcodes = true--沒有模板，沒有麻煩。

如何從影像讀取多個 BarCode？ 預設情況下，IronBarcode 會持續掃描文件以讀取多個條碼。 然而，曾有即使存在多個 BarCode，也只傳回一個條碼值的情況。 為解決這個問題，請自訂設定以啟用讀取多個 BarCode，如下所示。 **ExpectMultipleBarcodes** 屬性同時存在於 **BarcodeReaderOptions** 和 **PdfBarcodeReaderOptions** 類別中，讓您可以使用它來 [讀取影像和 PDF 文件中的條碼](https://ironsoftware.com/csharp/barcode/how-to/read-barcodes-from-pdf/)。

```cs :path=/static-assets/barcode/content-code-examples/how-to/read-multiple-barcodes-read-multiple-barcodes.cs ``` 將 **ExpectMultipleBarcodes** 設定為 true 可使 IronBarcode 掃描整個文件以獲得多個條碼，並將其儲存於 **BarcodeResults** 變數中。 使用 foreach 環路，您可以輕鬆存取並列印所有 BarCode 值到控制台。 ### 進階多重條碼讀取情境 在處理多個 BarCode 時，您可能會遇到需要額外設定的情況。 以下是一個綜合範例，示範如何從複雜的文件中讀取不同格式的多個 BarCode： ```cs 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 from various sources var imageResults = BarcodeReader.Read("mixed-barcodes.jpg", advancedOptions); var pdfResults = BarcodeReader.ReadPdf("document-with-barcodes.pdf", advancedOptions); // Process results with error handling foreach (var result in imageResults) { Console.WriteLine($"Barcode Type: {result.BarcodeType}"); Console.WriteLine($"Value: {result.Value}"); Console.WriteLine($"Confidence: {result.Confidence}%"); Console.WriteLine($"Page: {result.PageNumber}"); Console.WriteLine("---"); } ``` 這個進階範例展示了幾個重要的功能： - **混合條碼格式支援**：結合不同的 [ 條碼編碼類型](https://ironsoftware.com/csharp/barcode/get-started/supported-barcode-formats/)。 - **影像修正濾鏡**：使用[影像濾鏡](https://ironsoftware.com/csharp/barcode/features/filters/)來提高閱讀精確度 - **閱讀速度最佳化**：透過[閱讀速度選項](https://ironsoftware.com/csharp/barcode/how-to/reading-speed-options/)平衡速度與精確度 - **信心分數**：存取每個偵測到的 BarCode 的 可信度臨界值如何讀取單一 BarCode 以獲得更好的效能？ IronBarcode 可讀取影像或 PDF 中的單一或多重條碼。 預設情況下，即使只有一個 BarCode，引擎也會掃描整個文件。 為了提高讀取單一 BarCode 時的效能，請將 **ExpectMultipleBarcodes** 設為 false。 這可以讓引擎在偵測到第一個 BarCode 之後不再掃描整個文件，進而加快條碼擷取的速度。 下面的程式碼展示了這種方法。 <！--說明：比較單一與多重 BarCode 讀取模式處理時間的圖表 -->

```cs :path=/static-assets/barcode/content-code-examples/how-to/read-multiple-barcodes-read-single-barcode.cs ``` 在這個範例中，我們使用與之前相同的具有多個 BarCode 的圖片，但將 **ExpectMultipleBarcodes** 設為 false。 因此，只會傳回第一個條碼值，掃描過程在檢索到第一個條碼後停止。 ### 使用裁剪區域優化單一條碼讀取 為了在讀取單一 BarCode 時獲得更好的效能，請結合 **ExpectMultipleBarcodes = false** 設定與 [裁剪區域規格](https://ironsoftware.com/csharp/barcode/how-to/set-crop-region/)。 當您知道 BarCode 的大概位置時，此技術尤其有用： ```cs 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}"); Console.WriteLine($"Read time: {result.ReadTime}ms"); } ```

單一條碼讀取速度有多快？ 將 **ExpectMultipleBarcodes** 設為 false 可大幅提升讀取單一 BarCode 的效率。 在處理高解析度影像或在高吞吐量應用程式中實作 [ 異步條碼讀取](https://ironsoftware.com/csharp/barcode/how-to/async-multithread/)時，效能提升尤其顯著。 使用提供的程式碼片段，以下是同一台機器上將**ExpectMultipleBarcodes**設為 true 和 false 時效能差異的粗略估計：

ExpectMultipleBarcodes = true	ExpectMultipleBarcodes = false
0.91秒	0.10 秒

在讀取單一 BarCode 時，這代表大約 **9 倍的效能提升**。 實際的效能增益依下列因素而有所不同： - 影像解析度與複雜度 - 圖片中出現的 BarCode 數量 - 選取的 BarCode 格式 - 應用影像濾鏡 - 硬體規格 ### 多重條碼讀取的最佳實務 在生產應用程式中實作多重 BarCode 讀取時，請考慮這些最佳實務： 1.**指定期望的條碼類型**：不要使用 `BarcodeEncoding.All` 而只指定您期望的格式。 這可大幅提升效能。 2.**使用適當的圖像格式**：為達到最佳效果，請使用高對比度的圖片。 進一步了解 [建立最佳條碼影像](https://ironsoftware.com/csharp/barcode/how-to/create-barcode-images/)。 3.**處理不完美的 BarCode**：現實世界中的 BarCode 可能會損壞或印刷不良。 使用[影像修正技術](https://ironsoftware.com/csharp/barcode/how-to/image-correction/)來提高閱讀成功率。 4.**串流處理**：對於大量批次，請考慮 [ 從串流讀取](https://ironsoftware.com/csharp/barcode/how-to/read-barcodes-from-streams/)，以最佳化記憶體使用。 5.**錯誤處理**：對於無法讀取 BarCode 的情況，請務必執行適當的錯誤處理： ```cs 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 } ``` 遵循這些實踐並運用 IronBarcode 的全面功能，您可以建立強大的應用程式，有效地處理各行各業和使用個案中的多種條碼讀取情境。