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

如何提取和保存条形码图像？

IronBarcode读取图像后，图像中找到的条形码将存储在 BarcodeResult 中，作为 BarcodeImage 类型为 AnyBitmap 的属性。 BarcodeImage 属性存储找到的条形码图像。 用户可以检索该对象以进一步处理图像，或将其保存为永久副本。 这样可以省去从图像中提取 BarCode 图像的额外代码，从而提供效率和易用性。

下面的代码片段演示了这种输出格式的可能用例：

:path=/static-assets/barcode/content-code-examples/how-to/output-data-formats-BarcodeImage.cs

using IronBarCode;
using IronSoftware.Drawing;
using System.Collections.Generic;

// Read barcode from PDF file
BarcodeResults result = BarcodeReader.ReadPdf("test.pdf");

// Create list for barcodes
List<AnyBitmap> barcodeList = new List<AnyBitmap>();

foreach (BarcodeResult barcode in result)
{
    barcodeList.Add(barcode.BarcodeImage);
}

// Create multi-page TIFF
AnyBitmap.CreateMultiFrameTiff(barcodeList).SaveAs("barcodeImages.tif");

上面的代码片段说明了这种输出格式的一个用例。 具体来说，它可以从 PDF 文档中检测到的 BarCode 创建多页 TIFF 图像。 首先，我们扫描或检测样本PDF中的条码。 然后，我们创建一个 AnyBitmap 列表，并将 BarcodeImage 属性中的信息存储在其中。 最后，我们使用此列表通过 CreateMultiFrameTiff 方法生成多页 TIFF。 这种技术在处理 多页 GIF 和 TIFF 文件时特别有用。

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

如何通过编程识别不同的条形码类型？

该属性有助于确定输入图像或文档中的条形码类型。 不过，限制条件是图像内的条码类型必须是 IronBarcode 支持和可读的。 要了解 IronBarcode 中支持的条码类型的更多信息，请参阅此文章。 此外，请浏览支持的条形码格式的完整列表，以确保与您的特定要求兼容。

下面的代码片段演示了如何通过将值打印到控制台来检索图像中的条形码值和条形码类型。

:path=/static-assets/barcode/content-code-examples/how-to/output-data-formats-BarcodeType.cs

using IronBarCode;
using System;

// Read barcode from PNG
BarcodeResults result = BarcodeReader.Read("bc3.png");

// Output barcode type to console
foreach (BarcodeResult barcode in result)
{
    Console.WriteLine("The barcode value is " + barcode.ToString() + " and the barcode type is " + barcode.BarcodeType);
}

从上面的代码片段中，我们通过对输入图像调用 BarcodeReader.Read() 方法来执行条形码读取。 这将返回一个 BarcodeResults 对象，该对象存储从图像中读取的所有可用条形码的所有 BarcodeResult。 接下来，我们遍历 BarcodeResults 对象，检索 BarcodeResult 并将条形码值和类型打印到控制台。 这种方法可与各种条形码类型无缝衔接，包括 Code 39 条形码等专门格式。

何时应使用二进制值输出？

使用IronBarcode，用户可以通过访问 BarcodeResult 对象中的 BinaryValue 属性来检索条形码值的字节数组。 这使用户可以在程序中进一步操作条码值。 二进制值输出在处理加密数据、以 BarCode 编码的文件附件或与需要字节级数据处理的系统集成时特别有用。

下面的代码片段演示了检索条码值为二进制数据的一个用例：

:path=/static-assets/barcode/content-code-examples/how-to/output-data-formats-BinaryValue.cs

using IronBarCode;

// Read barcode from PNG
BarcodeResults result = BarcodeReader.Read("multiple-barcodes.png");

int i = 1;
foreach (BarcodeResult barcode in result)
{
    var binaryValue = barcode.BinaryValue;
    var barcodeType = IronBarCode.BarcodeEncoding.QRCode;

    // Create QR code
    GeneratedBarcode generatedBarcode = BarcodeWriter.CreateBarcode(binaryValue, barcodeType);

    // Export QR code
    generatedBarcode.SaveAsPng($"qrFromBinary{i}.png");
    i++;
}

观察上面的代码片段，我们创建了一个简单的程序，将图像中多个条码转换为单独的新的二进制编码文件。 首先，我们扫描样本PNG图像中的条码。 一旦我们检测到这些条形码，我们就遍历它们，访问 BinaryValue 属性，并使用它来创建新的二进制文件。 当您需要读取多个条形码并单独处理其二进制数据时，这种技术尤其有价值。

如何访问 BarCode 位置和尺寸？

用户可以访问的 BarcodeResult 对象的另一个属性是条形码的坐标，包括 Y2，以及它在图像文件或文档中的 Height 和 Width。 当用户需要检索有关 BarCode 位置和尺寸的信息时，这些属性非常有用。 这些空间信息对于需要精确定位的应用程序至关重要，例如自动文档处理、质量控制系统，或者在实施裁剪区域以优化条形码扫描时。

让我们来演示一下 BarCode 的位置和尺寸。

:path=/static-assets/barcode/content-code-examples/how-to/output-data-formats-height-width.cs

using IronBarCode;
using IronSoftware.Drawing;
using System.Linq;

// Read barcode from PNG
BarcodeResults result = BarcodeReader.Read("multiple-barcodes.png");

AnyBitmap bitmap = AnyBitmap.FromFile("multiple-barcodes.png");

foreach (BarcodeResult barcode in result)
{
    PointF[] barcodePoints = barcode.Points;

    float x1 = barcodePoints.Select(b => b.X).Min();
    float y1 = barcodePoints.Select(b => b.Y).Min();

    Rectangle rectangle = new Rectangle((int)x1, (int)y1, (int)barcode.Width!, (int)barcode.Height!);

    bitmap = bitmap.Redact(rectangle, Color.Magenta);

    // Save the image
    bitmap.SaveAs("redacted.png", AnyBitmap.ImageFormat.Png);
}

编辑前

编辑后

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

为什么页码对多页文档很重要？

用户可以检索发现 BarCode 的页码。 对于使用包含多个条形码的多页文档并需要知道在文档中发现的条形码位置以便进一步处理的用户来说，这是一项非常有用的功能。 在 从 PDF 文档中读取条形码或在企业应用程序中处理批量文档时，该功能至关重要。

请看下面的代码片段：

:path=/static-assets/barcode/content-code-examples/how-to/output-data-formats-page-number.cs

using IronBarCode;
using System;

// Read barcode from PDF
BarcodeResults result = BarcodeReader.ReadPdf("test.pdf");

// Output page number to console
foreach (BarcodeResult barcode in result)
{
    Console.WriteLine("The barcode value " + barcode.ToString() + " is found on page number " + barcode.PageNumber);
}

上面的代码片段演示了一个使用案例，用户需要程序返回在多页 PDF 文档中发现的 BarCode 的值及其各自的页码。 该代码使用 BarcodeReader.ReadPdf() 方法读取多页 PDF 文档中的条形码，返回 BarcodeResults 对象，该对象存储文档中找到的每个 BarcodeResult。 我们应用循环并遍历对象中的每个项目，以检索条码的值和发现条码的页码。 除此用例之外，用户还可以使用此属性来调试文档中的所有 BarCode 是否都已读取。

如何检测 BarCode 旋转和页面方向？

使用 IronBarcode，用户可以检索条形码方向和发现条形码的页面方向信息。 要提取这两条信息，请从 @@--CODE-695--CODE-695 对象访问 @@--CODE-693--CODE-694--CODE-695 属性。 Rotation 返回一个整数，表示找到的条形码的旋转角度。 该功能与图像方向校正功能配合使用，可确保条形码读取的准确性，而不受扫描角度的影响。

请看下面的代码片段：

:path=/static-assets/barcode/content-code-examples/how-to/output-data-formats-orientation.cs

using IronBarCode;
using System;

// Read barcode from PDF
BarcodeResults result = BarcodeReader.ReadPdf("test.pdf");

// Output page orientation and rotation to console
foreach (BarcodeResult barcode in result)
{
    Console.WriteLine(barcode.Value);
    Console.WriteLine(barcode.PageOrientation);
    Console.WriteLine(barcode.Rotation);
}

上面的代码片段与附加的示例 PDF 输入一起运行，以证明用户可以分别通过获取 BarcodeResult.PageOrientation 和 BarcodeResult.Rotation 的值来检索页面方向和条形码旋转。 此功能主要用于调试目的。

文本属性和值属性有什么区别？

当然，在使用IronBarcode时，用户最想获取的主要属性是其值和文本。 这两个属性经常交替使用，并返回相同的值。 除此之外，用户还可以使用 BarcodeResult.ToString() 方法来实现相同的结果。 在使用专业应用程序或以流形式导出条形码数据时，这些属性可提供灵活的方式，以您偏好的格式访问条形码内容。

下面的代码片段演示了：

:path=/static-assets/barcode/content-code-examples/how-to/output-data-formats-text-value.cs

using IronBarCode;
using System;

// Read barcode from PDF
BarcodeResults result = BarcodeReader.ReadPdf("barcodestamped3.pdf");

// Output text value to console
foreach (BarcodeResult barcode in result)
{
    Console.WriteLine(barcode.Value);
    Console.WriteLine(barcode.Text);
    Console.WriteLine(barcode.ToString());
}

从上面的代码片段来看，用户只需要几行代码就可以使用 IronBarcode 读取图像中的条形码。 在遍历 BarcodeReader.Read() 方法返回的 BarcodeResults 之后，我们将获取 Value 和 Text 属性的结果输出到控制台，并调用 BarcodeResult.ToString() 方法，以表明所有这些都返回相同的值。

总之，IronBarcode是一个完美的API，允许用户执行与条码相关的多个操作，不仅限于编写和解码条码。 IronBarcode返回的 BarcodeResult 对象支持多种输出数据格式，用户可以对它进行更多操作。