视频

How to Read Barcodes in C# 适用于 .NET 5 using IronBarcode

已更新:2026年6月20日

从Google ML Kit条形码扫描迁移到IronBarcode

本指南适用于以下两种情况之一的团队：您正在将 Android 应用程序移植到.NET MAUI或.NET 9，并且需要用托管替代方案替换 ML Kit 的条形码扫描器；或者您在跨平台条形码讨论中被推荐使用 Google ML Kit，但在添加NuGet包时发现它并不存在。

Google ML Kit 条形码扫描是一个原生 Android 和 iOS 库。它作为Maven依赖项发布（GoogleMLKit/BarcodeScanning）用于Swift。 ML Kit自2020年6月起成为独立产品，不再需要Firebase，但没有官方的.NET SDK，也没有dotnet add package google-mlkit-barcode，以及来自Google的第一方C# API。社区维护的Xamarin/MAUI绑定多年来曾经出现过，但每次ML Kit更新其基础SDK时都会破裂。

IronBarcode是一个原生.NET库，可通过NuGet安装，与标准.NET模式集成，并可在 Windows、Linux、macOS、Docker、Azure 和 AWS 上运行。本指南展示了如何将您用 Kotlin 或 Java 编写的模式转换为等效的 C# 代码。

移植背景

从 ML Kit 移植到IronBarcode时，一些结构上的变化不仅仅是语法上的变化：

回调变为返回值。 ML Kit使用Android的Task API与addOnFailureListener。 IronBarcode的BarcodeReader.Read()同步返回一个集合。你直接迭代它。没有回调注册，没有线程协调。

无扫描器对象。 ML Kit要求您构建一个scanner.process(inputImage)。 IronBarcode使用静态方法—BarcodeReader.Read()是入口点。没有需要管理或处置的实例。

无InputImage构造。 ML Kit的InputImage.fromMediaImage(image, rotation)。 IronBarcode接受文件路径字符串、一个System.Drawing.Bitmap。没有 Android 上下文，没有 URI，没有旋转元数据。

没有Google Play服务。未捆绑的ML Kit模型通过Google Play服务运行。捆绑变体将模型打包在APK内（增加约2.4 MB），避免了Play服务检查，但无论变体如何，.NET目标上均不可用。 IronBarcode没有这种依赖性——它在任何.NET支持的平台上都能完全运行。

.NET快速安装

如果您的项目中存在 Xamarin/MAUI ML Kit 绑定包，请将其移除，然后安装IronBarcode：

dotnet add package BarCode

在应用程序启动时添加许可证密钥—在Startup.cs中，具体取决于您的应用类型：

// NuGet: dotnet add package BarCode
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// NuGet: dotnet add package BarCode
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

$vbLabelText $csharpLabel

许可证可以在第一个BarcodeWriter.CreateBarcode()调用之前的任何时候设置。提供免费试用；试用模式下会生成带有水印的条形码，但不限制读取。

条形码读取：Kotlin 到 C

基本单条码读取

以下是 Kotlin 中典型的 ML Kit 读取示例，它扫描文件 URI 中的单个二维码：

// Android Kotlin — ML Kit
val options = BarcodeScannerOptions.Builder()
    .setBarcodeFormats(Barcode.FORMAT_QR_CODE)
    .build()
val scanner = BarcodeScanning.getClient(options)
val inputImage = InputImage.fromFilePath(context, imageUri)

scanner.process(inputImage)
    .addOnSuccessListener { barcodes ->
        val barcode = barcodes.firstOrNull()
        if (barcode != null) {
            Log.d("MLKit", "Value: ${barcode.rawValue}")
            Log.d("MLKit", "Format: ${barcode.format}")
        }
    }
    .addOnFailureListener { e ->
        Log.e("MLKit", "Scan failed: ${e.message}")
    }

在C#中使用IronBarcode实现的等效功能：

using IronBarCode;

try
{
    var results = BarcodeReader.Read("captured-image.jpg");
    var barcode = results.FirstOrDefault();
    if (barcode != null)
    {
        Console.WriteLine($"Value: {barcode.Value}");
        Console.WriteLine($"Format: {barcode.Format}");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Scan failed: {ex.Message}");
}

using IronBarCode;

try
{
    var results = BarcodeReader.Read("captured-image.jpg");
    var barcode = results.FirstOrDefault();
    if (barcode != null)
    {
        Console.WriteLine($"Value: {barcode.Value}");
        Console.WriteLine($"Format: {barcode.Format}");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Scan failed: {ex.Message}");
}

Imports IronBarCode

Try
    Dim results = BarcodeReader.Read("captured-image.jpg")
    Dim barcode = results.FirstOrDefault()
    If barcode IsNot Nothing Then
        Console.WriteLine($"Value: {barcode.Value}")
        Console.WriteLine($"Format: {barcode.Format}")
    End If
Catch ex As Exception
    Console.WriteLine($"Scan failed: {ex.Message}")
End Try

$vbLabelText $csharpLabel

结果会立即以返回值的形式提供。 barcode.rawValue。 barcode.format。错误处理采用标准的 try/catch 语句，而不是单独的失败监听器。

多条形码读取

ML Kit扫描一个InputImage并返回一个列表。对于一张图像中的多个条码，您需要迭代成功监听器的列表：

// Android Kotlin — ML Kit, multiple barcodes
val options = BarcodeScannerOptions.Builder()
    .setBarcodeFormats(Barcode.FORMAT_ALL_FORMATS)
    .build()
val scanner = BarcodeScanning.getClient(options)
val inputImage = InputImage.fromFilePath(context, imageUri)

scanner.process(inputImage)
    .addOnSuccessListener { barcodes ->
        for (barcode in barcodes) {
            val rawValue = barcode.rawValue
            val format = barcode.format
            processBarcode(rawValue, format)
        }
    }
    .addOnFailureListener { e -> Log.e("MLKit", e.message ?: "Unknown error") }

使用IronBarcode，在ExpectMultipleBarcodes = true并迭代结果集合：

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};

var results = BarcodeReader.Read("warehouse-shelf.jpg", options);
foreach (var barcode in results)
{
    Console.WriteLine($"Format: {barcode.Format}, Value: {barcode.Value}");
    ProcessBarcode(barcode.Value, barcode.Format);
}

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};

var results = BarcodeReader.Read("warehouse-shelf.jpg", options);
foreach (var barcode in results)
{
    Console.WriteLine($"Format: {barcode.Format}, Value: {barcode.Value}");
    ProcessBarcode(barcode.Value, barcode.Format);
}

Imports IronBarCode

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}

Dim results = BarcodeReader.Read("warehouse-shelf.jpg", options)
For Each barcode In results
    Console.WriteLine($"Format: {barcode.Format}, Value: {barcode.Value}")
    ProcessBarcode(barcode.Value, barcode.Format)
Next

$vbLabelText $csharpLabel

格式规范：将条形码格式设置为 BarcodeReaderOptions

ML Kit要求您通过setBarcodeFormats()指定要查找的格式。如果省略，ML Kit 将搜索所有格式。IronBarcode的工作原理相同——省略格式约束会搜索所有内容，但指定预期类型可以提高性能。

ML Kit Kotlin	IronBarcode C#
`Barcode.FORMAT_QR_CODE`	`BarcodeEncoding.QRCode`
`Barcode.FORMAT_CODE_128`	`BarcodeEncoding.Code128`
`Barcode.FORMAT_CODE_39`	`BarcodeEncoding.Code39`
`Barcode.FORMAT_CODE_93`	`BarcodeEncoding.Code93`
`Barcode.FORMAT_EAN_13`	`BarcodeEncoding.EAN13`
`Barcode.FORMAT_EAN_8`	`BarcodeEncoding.EAN8`
`Barcode.FORMAT_UPC_A`	`BarcodeEncoding.UPCA`
`Barcode.FORMAT_UPC_E`	`BarcodeEncoding.UPCE`
`Barcode.FORMAT_PDF417`	`BarcodeEncoding.PDF417`
`Barcode.FORMAT_DATA_MATRIX`	`BarcodeEncoding.DataMatrix`
`Barcode.FORMAT_AZTEC`	`BarcodeEncoding.Aztec`
`Barcode.FORMAT_ITF`	`BarcodeEncoding.ITF`
`Barcode.FORMAT_CODABAR`	`BarcodeEncoding.Codabar`
`Barcode.FORMAT_ALL_FORMATS`	省略`ExpectBarcodeTypes`

在IronBarcode中使用格式标志：

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128 | BarcodeEncoding.EAN13
};

var results = BarcodeReader.Read("product-image.jpg", options);

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128 | BarcodeEncoding.EAN13
};

var results = BarcodeReader.Read("product-image.jpg", options);

Imports IronBarCode

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .ExpectBarcodeTypes = BarcodeEncoding.QRCode Or BarcodeEncoding.Code128 Or BarcodeEncoding.EAN13
}

Dim results = BarcodeReader.Read("product-image.jpg", options)

$vbLabelText $csharpLabel

按位或运算组合的工作方式与 ML Kit 的可变参数格式列表相同。

结果访问：原始值和格式

ML Kit的结果对象公开Int常量）。 IronBarcode的结果公开BarcodeEncoding枚举值）。

//ML Kit Kotlin— result fields
val rawValue: String? = barcode.rawValue
val format: Int = barcode.format
val boundingBox: Rect? = barcode.boundingBox
val displayValue: String? = barcode.displayValue

//IronBarcode C#— result fields
string value = barcode.Value;
BarcodeEncoding format = barcode.Format;
int page = barcode.PageNumber; // populated for PDF / multi-page input

//IronBarcode C#— result fields
string value = barcode.Value;
BarcodeEncoding format = barcode.Format;
int page = barcode.PageNumber; // populated for PDF / multi-page input

'IronBarcode VB.NET— result fields
Dim value As String = barcode.Value
Dim format As BarcodeEncoding = barcode.Format
Dim page As Integer = barcode.PageNumber ' populated for PDF / multi-page input

$vbLabelText $csharpLabel

barcode.Value在IronBarcode中始终是一个不为null的字符串—如果读取成功，值是存在的。 if (barcode.Format == BarcodeEncoding.QRCode)。

.NET有什么不同之处

使用同步 API 而非回调函数。这是最重要的结构性变化。 ML Kit的Task<List<Barcode>>—您连接监听器。 IronBarcode的Task.Run()中：

using IronBarCode;

// In a MAUI ViewModel or page code-behind
var results = await Task.Run(() => BarcodeReader.Read(imagePath));
foreach (var barcode in results)
{
    // update UI on main thread
    MainThread.BeginInvokeOnMainThread(() =>
    {
        ResultLabel.Text = barcode.Value;
    });
}

using IronBarCode;

// In a MAUI ViewModel or page code-behind
var results = await Task.Run(() => BarcodeReader.Read(imagePath));
foreach (var barcode in results)
{
    // update UI on main thread
    MainThread.BeginInvokeOnMainThread(() =>
    {
        ResultLabel.Text = barcode.Value;
    });
}

Imports IronBarCode
Imports System.Threading.Tasks
Imports Microsoft.Maui.Dispatching

' In a MAUI ViewModel or page code-behind
Dim results = Await Task.Run(Function() BarcodeReader.Read(imagePath))
For Each barcode In results
    ' update UI on main thread
    MainThread.BeginInvokeOnMainThread(Sub()
                                           ResultLabel.Text = barcode.Value
                                       End Sub)
Next

$vbLabelText $csharpLabel

没有上下文参数。 每一个构建InputImage的ML Kit调用都需要一个Android Context。 IronBarcode只需要文件路径或流即可。从条形码逻辑中移除上下文线程可以大大简化代码。

没有Google Play服务。 标准ML Kit模型通过Play服务运行—BarcodeScanning.getClient()在运行时检查Play服务的可用性，如果不可用则会抛出异常。 IronBarcode没有运行时服务检查。它要么读取图像，要么抛出一个标准异常。

标准异常处理。 ML Kit的addOnFailureListener接收一个Java Exception子类。在.NET中，失败作为标准System.Exception抛出，按常规方式可通过try/catch捕获。

读取PDF文档

ML Kit 不支持 PDF。具有.pdf URI的InputImage.fromFilePath()要么失败，要么根据Android版本仅以光栅化图像读取第一页。如果您的移植场景涉及文档（例如发票处理、物流清单、表单扫描）， IronBarcode可以原生处理 PDF 文件：

using IronBarCode;

// Read all barcodes from all pages of a PDF
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};

var results = BarcodeReader.Read("invoice-batch.pdf", options);
foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}");
}

using IronBarCode;

// Read all barcodes from all pages of a PDF
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};

var results = BarcodeReader.Read("invoice-batch.pdf", options);
foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}");
}

Imports IronBarCode

' Read all barcodes from all pages of a PDF
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}

Dim results = BarcodeReader.Read("invoice-batch.pdf", options)
For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}")
Next

$vbLabelText $csharpLabel

无需图像提取步骤，无需第三方 PDF 库，无需页面迭代循环和单独渲染。传入 PDF 路径，获取所有条形码值及其页码。

新功能：一代

ML Kit 不生成条形码，它只读取条形码。如果您的移植应用程序需要生成标签、票据或二维码，IronBarcode的同一个软件包就能满足这些需求。

货运标签代码 128：

using IronBarCode;

BarcodeWriter.CreateBarcode("SHIP-2024-98341", BarcodeEncoding.Code128)
    .ResizeTo(400, 120)
    .SaveAsPng("shipping-label.png");

using IronBarCode;

BarcodeWriter.CreateBarcode("SHIP-2024-98341", BarcodeEncoding.Code128)
    .ResizeTo(400, 120)
    .SaveAsPng("shipping-label.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("SHIP-2024-98341", BarcodeEncoding.Code128) _
    .ResizeTo(400, 120) _
    .SaveAsPng("shipping-label.png")

$vbLabelText $csharpLabel

二维码生成：

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com/track/98341", 500)
    .SaveAsPng("tracking-qr.png");

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com/track/98341", 500)
    .SaveAsPng("tracking-qr.png");

Imports IronBarCode

QRCodeWriter.CreateQrCode("https://example.com/track/98341", 500) _
    .SaveAsPng("tracking-qr.png")

$vbLabelText $csharpLabel

带有徽标和颜色的二维码：

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com/product/4821", 500)
    .AddBrandLogo("company-logo.png")
    .ChangeBarCodeColor(System.Drawing.Color.DarkBlue)
    .SaveAsPng("product-qr.png");

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com/product/4821", 500)
    .AddBrandLogo("company-logo.png")
    .ChangeBarCodeColor(System.Drawing.Color.DarkBlue)
    .SaveAsPng("product-qr.png");

Imports IronBarCode

QRCodeWriter.CreateQrCode("https://example.com/product/4821", 500) _
    .AddBrandLogo("company-logo.png") _
    .ChangeBarCodeColor(System.Drawing.Color.DarkBlue) _
    .SaveAsPng("product-qr.png")

$vbLabelText $csharpLabel

作为 HTTP 响应的字节数组返回条形码：

using IronBarCode;

// In anASP.NET Corecontroller action
byte[] barcodeBytes = BarcodeWriter.CreateBarcode("ORDER-7734", BarcodeEncoding.QRCode)
    .ToPngBinaryData();

return File(barcodeBytes, "image/png");

using IronBarCode;

// In anASP.NET Corecontroller action
byte[] barcodeBytes = BarcodeWriter.CreateBarcode("ORDER-7734", BarcodeEncoding.QRCode)
    .ToPngBinaryData();

return File(barcodeBytes, "image/png");

Imports IronBarCode

' In an ASP.NET Core controller action
Dim barcodeBytes As Byte() = BarcodeWriter.CreateBarcode("ORDER-7734", BarcodeEncoding.QRCode) _
    .ToPngBinaryData()

Return File(barcodeBytes, "image/png")

$vbLabelText $csharpLabel

这些模式在 ML Kit 中都没有对应的模式。由于您使用的是完整的.NET条形码库，而不是仅限移动设备的扫描器，因此可以使用这些新功能。

服务器端批处理

ML Kit 每次调用处理一张图像，需要 Android/iOS 运行时环境，并且没有服务器端执行的概念。 IronBarcode以循环方式处理文件，在ASP.NET Core中运行，并且可以正常扩展：

using IronBarCode;

// Process a folder of scanned document images
var imageFiles = Directory.GetFiles("/data/scans", "*.jpg");
var allResults = new List<(string File, string Value, BarcodeEncoding Format)>();

foreach (var file in imageFiles)
{
    var options = new BarcodeReaderOptions
    {
        Speed = ReadingSpeed.Faster,
        ExpectMultipleBarcodes = false
    };

    var results = BarcodeReader.Read(file, options);
    foreach (var barcode in results)
    {
        allResults.Add((file, barcode.Value, barcode.Format));
    }
}

// Write results to CSV, database, etc.
foreach (var (file, value, format) in allResults)
{
    Console.WriteLine($"{file}: [{format}] {value}");
}

using IronBarCode;

// Process a folder of scanned document images
var imageFiles = Directory.GetFiles("/data/scans", "*.jpg");
var allResults = new List<(string File, string Value, BarcodeEncoding Format)>();

foreach (var file in imageFiles)
{
    var options = new BarcodeReaderOptions
    {
        Speed = ReadingSpeed.Faster,
        ExpectMultipleBarcodes = false
    };

    var results = BarcodeReader.Read(file, options);
    foreach (var barcode in results)
    {
        allResults.Add((file, barcode.Value, barcode.Format));
    }
}

// Write results to CSV, database, etc.
foreach (var (file, value, format) in allResults)
{
    Console.WriteLine($"{file}: [{format}] {value}");
}

Imports IronBarCode
Imports System.IO

' Process a folder of scanned document images
Dim imageFiles = Directory.GetFiles("/data/scans", "*.jpg")
Dim allResults = New List(Of (File As String, Value As String, Format As BarcodeEncoding))()

For Each file In imageFiles
    Dim options = New BarcodeReaderOptions With {
        .Speed = ReadingSpeed.Faster,
        .ExpectMultipleBarcodes = False
    }

    Dim results = BarcodeReader.Read(file, options)
    For Each barcode In results
        allResults.Add((file, barcode.Value, barcode.Format))
    Next
Next

' Write results to CSV, database, etc.
For Each result In allResults
    Console.WriteLine($"{result.File}: [{result.Format}] {result.Value}")
Next

$vbLabelText $csharpLabel

这种模式——读取图像文件夹、提取条形码、汇总结果——在 ML Kit 中是不可能的。这是IronBarcode的标准工作流程。

功能对比

特征	Google ML Kit	IronBarcode
.NET NuGet包	None	`BarCode`
C# / .NET API	None	是
条形码读取	是的（Android/iOS）	是的（所有平台）
条形码生成	否	是
二维码生成	否	是
二维码标志嵌入	否	是
PDF 输入	否	是
支持多页文档	否	是
摄像头/帧输入	是	通过图像文件
服务器端部署	否	是
ASP.NET Core	否	是
Azure Functions	否	是
Docker / Linux	否	是
需要 Google Play 服务	只支持未捆绑变体	否
Firebase依赖	不（自2020年6月以来独立）	否
同步.NET API	否	是
支持依赖注入	否	是的（静态 API）
`ExpectMultipleBarcodes`选项	通过结果列表	`BarcodeReaderOptions`
格式规范	`setBarcodeFormats()`	`ExpectBarcodeTypes`
速度/精度权衡	固定（基于模型）	`ReadingSpeed`枚举
定价	免费（仅限设备上的移动）	从$749（Lite）永久
平台	Android、iOS	Windows、Linux、macOS、Docker、Azure、AWS

迁移清单

如果您正在移植 Android 代码库或替换非官方的 Xamarin ML Kit 绑定，请在您的项目中搜索这些模式并应用上述转换：

Gradle文件中的com.google.mlkit:barcode-scanning → 移除，添加BarCode NuGet
BarcodeScannerOptions.Builder() → new BarcodeReaderOptions { }
BarcodeScanning.getClient(options) → 移除（IronBarcode中无扫描器实例）
InputImage.fromFilePath(context, uri) → 文件路径字符串参数
InputImage.fromBitmap(bitmap, rotation) → BarcodeReader.Read(stream)或字节数组重载
scanner.process(inputImage) → BarcodeReader.Read(path, options)
.addOnSuccessListener { barcodes -> } → 迭代Read()的返回值
.addOnFailureListener { e -> } → 在Read()周围使用try/catch
barcode.rawValue → barcode.Value
barcode.format → barcode.Format
Barcode.FORMAT_QR_CODE → BarcodeEncoding.QRCode
Barcode.FORMAT_CODE_128 → BarcodeEncoding.Code128
Barcode.FORMAT_ALL_FORMATS → 省略ExpectBarcodeTypes
using Google.MLKit.BarcodeScanning;（Xamarin绑定）→ using IronBarCode;
应在IronBarCode.License.LicenseKey

从基于回调的代码到同步代码的结构性改变是主要工作。格式常量和结果字段名称是直接映射。 PDF 和生成支持完全是新增的——不需要迁移，只需要新的代码。

常见问题解答

我为什么要从 Google ML Kit 条形码扫描迁移到 IronBarcode？

常见原因包括简化许可（消除 SDK + 运行时密钥的复杂性）、消除吞吐量限制、获得原生 PDF 支持、改进 Docker/CI/CD 部署以及减少生产代码中的 API 样板代码。

如何用 IronBarcode 替换 Google ML Kit API 调用？

用 `IronBarCode.License.LicenseKey = "key"` 替换实例创建和许可相关的样板代码。用 `BarcodeReader.Read(path)` 替换读取器调用，用 `BarcodeWriter.CreateBarcode(data, encoding)` 替换写入器调用。静态方法无需实例管理。

从 Google ML Kit 条形码扫描迁移到 IronBarcode 时，需要进行多少代码更改？

大多数迁移都能减少代码行数。许可样板代码、实例构造函数和显式格式配置都被移除。核心读/写操作映射到更简洁的 IronBarcode 等效代码，并生成更清晰的结果对象。

迁移过程中是否需要同时保留 Google ML Kit 条形码扫描和 IronBarcode 这两个组件？

不。大多数迁移都是直接替换，而不是并行操作。一次迁移一个服务类，替换 NuGet 引用，并更新实例化和 API 调用模式，然后再迁移下一个类。

IronBarcode 的 NuGet 包名称是什么？

该软件包名为“IronBarCode”（B 和 C 大写）。使用“Install-Package IronBarCode”或“dotnet add package IronBarCode”进行安装。代码中的 using 指令为“using IronBarCode;”。

与 Google ML Kit 条形码扫描相比，IronBarcode 如何简化 Docker 部署？

IronBarcode 是一个 NuGet 包，不包含任何外部 SDK 文件或已挂载的许可证配置。在 Docker 环境中，设置 IRONBARCODE_LICENSE_KEY 环境变量后，该包会在启动时自动处理许可证验证。

从 Google ML Kit 迁移后，IronBarcode 是否能自动检测所有条形码格式？

是的。IronBarcode 可以自动检测所有支持格式的条码符号，无需显式枚举 BarcodeTypes。如果已知条码格式且性能至关重要，BarcodeReaderOptions 允许缩小搜索范围以进行优化。

IronBarcode 能否在不使用单独库的情况下读取 PDF 中的条形码？

是的。`BarcodeReader.Read("document.pdf")` 可以直接处理 PDF 文件。结果包括每个条形码的页码、格式、值和置信度。无需外部 PDF 渲染步骤。

IronBarcode如何处理并行条码处理？

IronBarcode 的静态方法是无状态且线程安全的。可以直接对文件列表使用 Parallel.ForEach，无需进行线程级实例管理。BarcodeReaderOptions.MaxParallelThreads 控制内部线程预算。

从 Google ML Kit 条形码扫描迁移到 IronBarcode 时，哪些结果属性会发生变化？

常见重命名：BarcodeValue 变为 Value，BarcodeType 变为 Format。IronBarcode 结果还会添加 Confidence 和 PageNumber。解决方案范围内的查找替换功能会处理现有结果处理代码中的重命名。

如何在 CI/CD 流水线中设置 IronBarcode 许可？

将 IRONBARCODE_LICENSE_KEY 存储为管道密钥，并在应用程序启动代码中赋值 IronBarCode.License.LicenseKey。一个密钥即可覆盖所有环境，包括开发、测试、预发布和生产环境。

IronBarcode是否支持生成自定义样式的二维码？

是的。QRCodeWriter.CreateQrCode() 支持通过 ChangeBarCodeColor() 自定义颜色、通过 AddBrandLogo() 嵌入徽标、可配置纠错级别以及多种输出格式，包括 PNG、JPG、PDF 和流媒体。

Curtis Chau

立即与工程团队聊天

技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外，Curtis 对物联网 (IoT) 有浓厚的兴趣，探索将硬件和软件集成的新方法。在空闲时间，他喜欢玩游戏和构建 Discord 机器人，将他对技术的热爱与创造力相结合。

已发布2026年5月17日

如何用 C# | IronPDF 编写 Unicode 和国际语言条形码

了解如何使用 C# 和 IronBarcode 将 Unicode 文本（如非英语字符和表情符号）写入条形码。本视频教程为您提供逐步指导，以提高您的条形码编码技能，使您能够高效地融入多样化的字符和符号。

已更新2026年5月19日

How To Set Error Correction in C# | IronQR

Discover how to make your QR codes more robust with error correction in IronBarcode for C#. This video provides step-by-step guidance on setting error correction levels to keep your codes readable, despite potential damage or smudging.

已发布2026年5月15日

How to Fix Barcode Orientation in C# | IronBarcode

Learn to automatically fix rotated barcodes in images using IronBarcode in C#. This guide provides a simple and effective solution to enhance barcode scanning accuracy.

如何使用C#和.NET MAUI读取和扫描条形码

How to Generate Barcode Images in C...

客户亮点：

开发者焦点：

网络研讨会：

开始免费 30 天试用

How to Read Barcodes in C# 适用于 .NET 5 using IronBarcode

从Google ML Kit条形码扫描迁移到IronBarcode

移植背景

.NET快速安装

条形码读取：Kotlin 到 C

基本单条码读取

多条形码读取

格式规范：将条形码格式设置为 BarcodeReaderOptions

结果访问：原始值和格式

.NET有什么不同之处

读取PDF文档

新功能：一代

服务器端批处理

功能对比

迁移清单

常见问题解答

我为什么要从 Google ML Kit 条形码扫描迁移到 IronBarcode？

如何用 IronBarcode 替换 Google ML Kit API 调用？

从 Google ML Kit 条形码扫描迁移到 IronBarcode 时，需要进行多少代码更改？

迁移过程中是否需要同时保留 Google ML Kit 条形码扫描和 IronBarcode 这两个组件？

IronBarcode 的 NuGet 包名称是什么？

与 Google ML Kit 条形码扫描相比，IronBarcode 如何简化 Docker 部署？

从 Google ML Kit 迁移后，IronBarcode 是否能自动检测所有条形码格式？

IronBarcode 能否在不使用单独库的情况下读取 PDF 中的条形码？

IronBarcode如何处理并行条码处理？

从 Google ML Kit 条形码扫描迁移到 IronBarcode 时，哪些结果属性会发生变化？

如何在 CI/CD 流水线中设置 IronBarcode 许可？

IronBarcode是否支持生成自定义样式的二维码？

您的许可证密钥已发送到您的收件箱

您的演示请求已提交。

钢铁支援团队

开始免费 30 天试用

How to Read Barcodes in C# 适用于 .NET 5 using IronBarcode

从Google ML Kit条形码扫描迁移到IronBarcode

移植背景

.NET快速安装

条形码读取：Kotlin 到 C

基本单条码读取

多条形码读取

格式规范：将条形码格式设置为 BarcodeReaderOptions

结果访问：原始值和格式

.NET有什么不同之处

读取PDF文档

新功能：一代

服务器端批处理

功能对比

迁移清单

常见问题解答

我为什么要从 Google ML Kit 条形码扫描迁移到 IronBarcode？

如何用 IronBarcode 替换 Google ML Kit API 调用？

从 Google ML Kit 条形码扫描迁移到 IronBarcode 时，需要进行多少代码更改？

迁移过程中是否需要同时保留 Google ML Kit 条形码扫描和 IronBarcode 这两个组件？

IronBarcode 的 NuGet 包名称是什么？

与 Google ML Kit 条形码扫描相比，IronBarcode 如何简化 Docker 部署？

从 Google ML Kit 迁移后，IronBarcode 是否能自动检测所有条形码格式？

IronBarcode 能否在不使用单独库的情况下读取 PDF 中的条形码？

IronBarcode如何处理并行条码处理？

从 Google ML Kit 条形码扫描迁移到 IronBarcode 时，哪些结果属性会发生变化？

如何在 CI/CD 流水线中设置 IronBarcode 许可？

IronBarcode是否支持生成自定义样式的二维码？

相关文章

如何用 C# | IronPDF 编写 Unicode 和国际语言条形码

How To Set Error Correction in C# | IronQR

How to Fix Barcode Orientation in C# | IronBarcode

下一步：开始免费 30 天试用

Thank You

下一步：开始免费 30 天试用

想免费将 IronSuite 部署到实际项目中吗？

包括什么？

您的许可证密钥已发送到您的收件箱

您的演示请求已提交。

深受全球数百万工程师信赖

钢铁支援团队