如何在 C# 中从 System.Drawing 中读取条形码。

简介

<! -- 待办事项：在此处添加图片 --> <! -- --> <！--说明：说明代码概念的图表或截图 -->

System.Drawing 对象在 .NET 中广泛用于图像处理任务。 然而，Microsoft 已停止在MacOS和Linux上对System.Drawing的支持，现在仅支持Windows。 这一变化给在非 Windows 操作系统上使用 IronBarcode 的开发人员带来了问题，因为处理条形码通常涉及 图形、图像 和 字体。

为了解决这个问题，我们引入了IronDrawing。 这个由 IronSoftware 创建的免费和开源库简化了跨平台支持并提供了无缝体验。 当您从 NuGet 安装 IronBarcode 时，IronDrawing 会自动包含在您的项目中。

对于刚刚接触条形码阅读的开发人员，请参阅我们全面的 阅读条形码教程，其中涵盖基本概念和基本使用模式。 如果您正在使用各种图像格式，我们的从图像中读取 BarCode 指南提供了更多的上下文和示例。

as-heading:2（快速入门：使用 AnyBitmap 一行轻松读取条形码）

该代码段展示了 IronBarcode 如何通过创建一个 System.Drawing.Bitmap 并让 IronDrawing 将其隐式地转换为 AnyBitmap 来读取条形码。 只需一行，任何操作系统上的开发人员都能快速获得结果。

如何将 `System.Drawing` 对象铸造为 `AnyBitmap`? <！--说明：说明代码概念的图表或截图 --> 从 `System.Drawing` 中读取条形码需要将对象铸入 `AnyBitmap` 中。 `IronDrawing`是为易于使用而设计的，它支持将图像对象从`System.Drawing`隐式转换为名为`AnyBitmap`的`IronSoftware.Drawing`图像对象。 除了`System.Drawing`对象外，我们还支持从其他类型铸造： - **`System.Drawing.Bitmap`** - **`System.Drawing.Image`** - **`SkiaSharp.SKBitmap`** - **`SkiaSharp.SKImage`** - **`SixLabors.ImageSharp`** 请参阅此[代码示例](/open-source/csharp/drawing/examples/cast-to-anybitmap/)来铸造上述对象。 下面演示了将 `System.Drawing` 对象中的条形码图像转换为 `IronSoftware.Drawing.AnyBitmap` 对象：

哪些 `System.Drawing` 类型可以被套用？ ```csharp :path=/static-assets/barcode/content-code-examples/how-to/read-barcodes-from-system-drawing-cast-to-anybitmap.cs ``` 本代码通过 `IronDrawing` 演示了 `System.Drawing` 对象和 `IronBarcode` 之间的无缝集成。 这种兼容性适用于各种条形码格式，详见我们的[支持的条形码格式指南](https://ironsoftware.com/csharp/barcode/get-started/supported-barcode-formats/)，包括 QR 码、Code 128、Code 39 和许多其他条形码格式。

隐式铸造为何有效？ 在上面的代码中，我们以 `System.Drawing.Bitmap` 和 `System.Drawing.Image` 的方式加载了两个条形码图像。 然后，我们通过将它们赋值给 `AnyBitmap` 对象，隐式地将它们转换为 `AnyBitmap` 对象，然后将这些对象添加到 `AnyBitmap` 列表中。 `IronDrawing` 的隐式铸造机制使用操作符重载，提供 `System.Drawing` 类型和 `AnyBitmap` 之间的透明转换。 这种设计模式可以让开发人员维护现有代码，同时获得跨平台兼容性。 转换时要保留所有图像属性，包括分辨率、色深和像素数据，确保无质量损失。

何时应使用显式铸造与隐式铸造？ 虽然隐式转换提供了便利，但在某些情况下显式转换可能更受欢迎： ```csharp // Implicit casting - clean and simple for straightforward conversions System.Drawing.Bitmap systemBitmap = new System.Drawing.Bitmap("barcode.png"); AnyBitmap anyBitmap = systemBitmap; // Implicit cast // Explicit casting - useful when type clarity is important System.Drawing.Image systemImage = System.Drawing.Image.FromFile("qrcode.jpg"); AnyBitmap explicitBitmap = (AnyBitmap)systemImage; // Explicit cast // When working with nullable types or conditional logic System.Drawing.Bitmap? nullableBitmap = GetBitmapFromSource(); if (nullableBitmap != null) { AnyBitmap result = (AnyBitmap)nullableBitmap; // Explicit cast for clarity // Process the barcode } ```

哪些是常见的铸造错误？ 在将 `System.Drawing` 转换为 `AnyBitmap` 时，开发人员可能会遇到以下问题： 1.**空引用异常**：在转换之前验证您的 `System.Drawing` 对象是否为空 2.**不支持的格式异常**：某些特殊的图像格式需要预先转换。 3.**内存问题**：大图片需要适当的处理模式 对于铸造问题的故障排除，我们的[故障排除指南](https://ironsoftware.com/csharp/barcode/troubleshooting/barcode-not-recognized/)提供了条形码识别过程中常见问题的解决方案。

如何从 `AnyBitmap` 对象中读取条形码？ <！--说明：说明代码概念的图表或截图 --> IronBarcode 在所有方法中都接受 **`IronSoftware.Drawing.AnyBitmap`**对象，无需额外配置。 这将简化在非 Windows 操作系统上使用 `System.Drawing` 对象时的开发工作。 以下代码演示了这一点：

哪些方法接受 `AnyBitmap` 参数？ ```csharp :path=/static-assets/barcode/content-code-examples/how-to/read-barcodes-from-system-drawing-read-anybitmap.cs ``` 除了基本的 `Read` 方法外，IronBarcode 还提供了多种可接受 `AnyBitmap` 参数的方法。 有关高级应用场景，请参阅我们的[读取多个条形码](https://ironsoftware.com/csharp/barcode/how-to/read-multiple-barcodes/)指南，该指南演示了对单个图像中多个条形码的高效处理： ```csharp // Advanced barcode reading with options var readerOptions = new BarcodeReaderOptions { // Specify barcode types to search for ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128, // Enable machine learning for better accuracy UseML = true, // Set confidence threshold Confidence = 0.95 }; // Read with specific options var advancedResults = BarcodeReader.Read(anyBitmap, readerOptions); ```

如何处理多个 BarCode 结果？ 上面的代码扩展了前面的示例。 在填充 `AnyBitmap` 列表后，我们遍历该列表并调用每个 `AnyBitmap` 对象上的 `Read` 方法，该方法将返回 **`IronBarcode.BarcodeResults`** 。 然后，我们对结果进行迭代，将 BarCode 值打印到控制台。 处理多个 BarCode 时，利用并行处理提高性能： ```csharp // Parallel processing for multiple barcode images var barcodeFiles = Directory.GetFiles("barcodes/", "*.png"); var allResults = new ConcurrentBag(); Parallel.ForEach(barcodeFiles, file => { var bitmap = new System.Drawing.Bitmap(file); var anyBitmap = (AnyBitmap)bitmap; var results = BarcodeReader.Read(anyBitmap); foreach (var result in results) { allResults.Add(result); } bitmap.Dispose(); // Clean up resources }); // Process all results foreach (var result in allResults) { Console.WriteLine($"Found {result.BarcodeType}: {result.Value}"); } ```

我还可以使用哪些 `IronDrawing` 功能？ `IronSoftware.Drawing`的功能不仅限于铸造图像。 它可以处理图像处理方面的问题，如 **颜色**和 **字体**，这对条形码和二维码的样式设计非常有用。 探索我们如何利用 `IronDrawing` 来 [自定义和添加徽标到 QR 代码](https://ironsoftware.com/csharp/barcode/how-to/customize-qr-code-style/)。 `IronDrawing`提供强大的图像处理功能，是对条形码处理的补充： ```csharp // Using IronDrawing for image preprocessing using IronSoftware.Drawing; // Load and preprocess an image before barcode reading AnyBitmap preprocessedImage = AnyBitmap.FromFile("noisy-barcode.jpg"); // Apply image filters to improve barcode readability preprocessedImage = preprocessedImage.ToGrayScale(); preprocessedImage = preprocessedImage.Contrast(1.5); // Increase contrast preprocessedImage = preprocessedImage.Sharpen(); // Sharpen image // Read the preprocessed barcode var improvedResults = BarcodeReader.Read(preprocessedImage); ``` 对于需要进行特定图像校正的场景，我们的[图像校正指南](https://ironsoftware.com/csharp/barcode/how-to/image-correction/)详细介绍了如何使用过滤器来增强条形码的可读性。

为什么选择 `IronDrawing` 而不是 `System.Drawing`? `IronDrawing` 与 `System.Drawing` 相比具有令人信服的优势： 1.**跨平台支持**：与 `System.Drawing` 不同（在 .NET Core/5+ 中仅支持 Windows），可在 Windows、Linux 和 macOS 上无缝运行。 2.**现代架构**：基于 `SkiaSharp` 和 `ImageSharp` 构建，具有更好的性能和内存管理。 3.**简化的 API**：保持熟悉的 `System.Drawing` 类接口，同时添加现代便利功能 4.**积极开发**：定期更新和改进，与维护模式下的 `System.Drawing` 不同 5.**更好的集成**：专为实现与 IronSoftware 产品的最佳性能而设计 有关部署注意事项，尤其是云环境，请参阅我们的[部署到 Azure](https://ironsoftware.com/csharp/barcode/get-started/azure/) 和[部署到 AWS](https://ironsoftware.com/csharp/barcode/get-started/aws/) 指南，其中包括有关使用 `IronDrawing` 的跨平台兼容性的具体说明。 无论是构建桌面应用程序、Web 服务还是云原生解决方案，`IronDrawing` 都能确保您的条形码处理代码在所有平台上保持可移植性和高效性，使其成为现代 .NET 开发的理想选择。