如何使用 IronBarcode 在 C# 中输出数据格式。

IronBarcode 可从条码读取中提供多种输出格式，包括 BarcodeImage, BarcodeType, BinaryValue, 坐标、尺寸、页码、方向、文本和值属性。 这些格式能够以编程方式处理条形码数据，适用于各种用例。

IronBarcode 不只是简单地读取条形码并在控制台中打印数值，它还提供了更多的功能。 它提供了多种输出格式，为用户处理阅读结果铺平了道路。 这些格式包括条码图像、条码类型、BinaryValue、坐标、高度、宽度、页码、条码、页面方向、文本和值等属性。

用户可以在程序中进一步操作这些属性。 让我们来探讨一下如何使用这些属性以及在哪些用例中它们会有所帮助。

快速入门：在一行中读取条码值和类型

本示例展示了如何使用 IronBarcode 从图像中读取条形码--一行加载，然后立即打印条形码的值和类型。 非常适合快速入门。如需了解更全面的示例，请查看Barcode快速入门指南。

有哪些可用的输出格式及其使用案例？ -->。 <！--说明：显示代码执行输出或结果的截图 --> `BarcodeResult`储存了多种有用的属性。 这些属性如下所列： - `BarcodeImage` - `BarcodeType` - `BinaryValue` - 坐标、高度和宽度 - `PageNumber` - `Barcode`和`PageOrientation` - 文本和值 每种属性在 BarCode 处理工作流程中都有特定用途。 无论是构建库存管理系统、文档处理流水线还是质量控制应用程序，这些数据格式都为[读取各种来源的条形码](https://ironsoftware.com/csharp/barcode/how-to/read-barcodes-from-images/)提供了所需的灵活性。

如何提取和保存条形码图像？ IronBarcode 读取图像后，图像中的条形码将作为 `AnyBitmap` 类型的 `BarcodeImage` 属性存储在 `BarcodeResult` 中。 `BarcodeImage`属性存储找到的条码图像。 用户可以检索该对象以进一步处理图像，或将其保存为永久副本。 这样可以省去从图像中提取 BarCode 图像的额外代码，从而提供效率和易用性。 下面的代码片段演示了这种输出格式的可能用例： ```csharp :path=/static-assets/barcode/content-code-examples/how-to/output-data-formats-BarcodeImage.cs ``` 上面的代码片段说明了这种输出格式的一个用例。 具体来说，它可以从 PDF 文档中检测到的 BarCode 创建多页 TIFF 图像。 首先，我们扫描或检测样本PDF中的条码。 然后，我们创建了一个`AnyBitmap`列表，在其中存储了来自`BarcodeImage`属性的信息。 最后，我们使用该列表，使用 `CreateMultiFrameTiff` 方法生成多页 TIFF。 这种技术在处理 [ 多页 GIF 和 TIFF 文件](https://ironsoftware.com/csharp/barcode/how-to/read-barcodes-from-multi-page-frame-tiff-gif/)时特别有用。

请注意 `BarcodeResult`中的`BarcodeImage`属性仅存储读取过程中找到的条形码图像，而不是整个输入图像本身。

如何通过编程识别不同的条形码类型？ 该属性有助于确定输入图像或文档中的条形码类型。 不过，限制条件是图像内的条码类型必须是 IronBarcode 支持和可读的。 要了解 IronBarcode 中支持的条码类型的更多信息，请参阅此[文章](https://ironsoftware.com/csharp/barcode/how-to/read-barcodes-from-images/#expectbarcodetypes)。 此外，请浏览[支持的条形码格式](https://ironsoftware.com/csharp/barcode/get-started/supported-barcode-formats/)的完整列表，以确保与您的特定要求兼容。 下面的代码片段演示了如何通过将值打印到控制台来检索图像中的条形码值和条形码类型。 ```csharp :path=/static-assets/barcode/content-code-examples/how-to/output-data-formats-BarcodeType.cs ``` 从上面的代码片段中，我们通过在输入图像上调用`BarcodeReader.Read()`方法进行条码读取。 这返回一个`BarcodeResults`对象，存储读取图像中所有可用条码的`BarcodeResult`。 接下来，我们迭代`BarcodeResults`对象以检索`BarcodeResult`，并将条码值和类型打印到控制台。 这种方法可与各种条形码类型无缝衔接，包括 [Code 39 条形码](https://ironsoftware.com/csharp/barcode/how-to/read-code39-barcodes/)等专门格式。

何时应使用二进制值输出？ 使用 IronBarcode，用户可以通过访问 `BarcodeResult` 对象中的 `BinaryValue` 属性来检索条形码值的字节数组。 这使用户可以在程序中进一步操作条码值。 二进制值输出在处理加密数据、以 BarCode 编码的文件附件或与需要字节级数据处理的系统集成时特别有用。 下面的代码片段演示了检索条码值为二进制数据的一个用例： ```csharp :path=/static-assets/barcode/content-code-examples/how-to/output-data-formats-BinaryValue.cs ``` 观察上面的代码片段，我们创建了一个简单的程序，将图像中多个条码转换为单独的新的二进制编码文件。 首先，我们扫描样本PNG图像中的条码。 检测到这些 BarCode 后，我们会遍历它们，访问 `BinaryValue` 属性，并使用它创建新的二进制文件。 当您需要[读取多个条形码](https://ironsoftware.com/csharp/barcode/how-to/read-barcodes-from-images/)并单独处理其二进制数据时，这种技术尤其有价值。

如何访问 BarCode 位置和尺寸？ 用户可以访问条码的坐标，包括`X1`、`Y1`、`X2`、`Y2`以及图像文件或文档中的`Height`和`Width`。 当用户需要检索有关 BarCode 位置和尺寸的信息时，这些属性非常有用。 这些空间信息对于需要精确定位的应用程序至关重要，例如自动文档处理、质量控制系统，或者在实施[裁剪区域](https://ironsoftware.com/csharp/barcode/how-to/set-crop-region/)以优化条形码扫描时。 让我们来演示一下 BarCode 的位置和尺寸。 ```csharp :path=/static-assets/barcode/content-code-examples/how-to/output-data-formats-height-width.cs ```

编辑前

编辑后

上面的代码片段编辑了图像文件中的多个 BarCode。为此，我们结合使用了 IronBarcode 和 IronDrawing 这两个库。 要获得`BarcodeResult`对象并从中提取属性，我们首先使用`BarcodeReader.Read()`方法读取图像文件中可用的条码。 同时，需要将输入的图像文件转换为 `AnyBitmap` 对象，以便对图像应用节录方法。 一旦我们得到了`BarcodeResults`对象，我们可以应用循环并遍历它，以获取每个可用条码的`X1`、`Y1`、`Width`和`Height`，并将它们用在`AnyBitmap.Redact()`方法的`CropRectangle`属性中。

为什么页码对多页文档很重要？ 用户可以检索发现 BarCode 的页码。 对于使用包含多个条形码的多页文档并需要知道在文档中发现的条形码位置以便进一步处理的用户来说，这是一项非常有用的功能。 在 [ 从 PDF 文档中读取条形码](https://ironsoftware.com/csharp/barcode/how-to/read-barcodes-from-pdf/)或在企业应用程序中处理批量文档时，该功能至关重要。 请看下面的代码片段： ```csharp :path=/static-assets/barcode/content-code-examples/how-to/output-data-formats-page-number.cs ``` 上面的代码片段演示了一个使用案例，用户需要程序返回在多页 PDF 文档中发现的 BarCode 的值及其各自的页码。 代码使用 `BarcodeReader.ReadPdf()` 方法读取多页 PDF 文档中的条形码，并返回 `BarcodeResults` 对象，该对象存储了在文档中发现的每个 `BarcodeResult` 。 我们应用循环并遍历对象中的每个项目，以检索条码的值和发现条码的页码。 除此用例之外，用户还可以使用此属性来调试文档中的所有 BarCode 是否都已读取。

请注意此属性返回的值**基于 1** ，这意味着第一页始终为**1**而**不是 0。**

如何检测 BarCode 旋转和页面方向？ 使用 IronBarcode，用户可以检索条形码方向和发现条形码的页面方向信息。 要提取这两条信息，请访问 `BarcodeResult` 对象中的 `Rotation` 和 `PageOrientation` 属性。 `Rotation` 返回一个整数，表示找到的条形码的旋转角度。 该功能与[图像方向校正](https://ironsoftware.com/csharp/barcode/how-to/image-orientation-correction/)功能配合使用，可确保条形码读取的准确性，而不受扫描角度的影响。 请看下面的代码片段： ```csharp :path=/static-assets/barcode/content-code-examples/how-to/output-data-formats-orientation.cs ``` 上面的代码片段与所附的 PDF 输入示例一起运行，以证明用户可以分别通过获取 `BarcodeResult.PageOrientation` 和 `BarcodeResult.Rotation` 的值来检索页面方向和条形码旋转。 此功能主要用于调试目的。 IronBarcode 只能读取旋转角度为`0`和`180` `270` `90`条形码。 如果条码的旋转值不在上述提到的范围内，IronBarcode将不返回任何值。 `PageOrientation` 返回一个 [`PageOrientation`](https://ironsoftware.com/csharp/barcode/object-reference/api/IronBarCode.PageOrientation.html) 对象，该对象由 `Portrait` 或 `Landscape` 组成。)}]

文本属性和值属性有什么区别？ 当然，在使用IronBarcode时，用户最想获取的主要属性是其**值**和**文本**。 这两个属性经常交替使用，并返回相同的值。 除此之外，用户还可以使用 `BarcodeResult.ToString()` 方法实现相同的结果。 在使用专业应用程序或[以流形式导出条形码数据](https://ironsoftware.com/csharp/barcode/how-to/export-barcode-as-stream/)时，这些属性可提供灵活的方式，以您偏好的格式访问条形码内容。 下面的代码片段演示了： ```csharp :path=/static-assets/barcode/content-code-examples/how-to/output-data-formats-text-value.cs ``` 从上面的代码片段来看，用户只需要几行代码就可以使用 IronBarcode 读取图像中的条形码。 在遍历 `BarcodeReader.Read()` 方法返回的 `BarcodeResults` 之后，我们向控制台输出获取 `Value` 和 `Text` 属性以及调用 `BarcodeResult.ToString()` 方法的结果，以显示所有这些返回值相同。 总之，IronBarcode是一个完美的API，允许用户执行与条码相关的多个操作，不仅限于编写和解码条码。 IronBarcode 支持多种输出数据格式，用户可以使用 IronBarcode 返回的 `BarcodeResult` 对象进行更多操作。