MessagingToolkit 条形码库与 IronBarcode 对比：C# 条形码库比较

平台和维护记录

MessagingToolkit.Barcode 的NuGet包元数据记录了其预期目标。 下表中的每个条目都代表该库开发时处于当前或接近当前状态的平台：

该库没有与.NET Core、 .NET 5、 .NET 6、 .NET 7、 .NET 8 或.NET 9 兼容的目标框架。面向这些运行时的项目在包无法解析兼容的框架名称时会遇到构建时失败——这不是运行时警告，而是编译错误。

详细功能对比

MessagingToolkit.条形码方法

MessagingToolkit.Barcode 仅针对.NET Framework 3.5、4.0 和 4.5。 它没有.NET Standard 的名称，没有.NET Core 的目标，也没有针对现代运行时的兼容性补丁。 当项目文件引用此包并面向任何现代.NET版本时， NuGet还原操作将失败，并出现框架兼容性错误——生成不会继续。

NuGet元数据中的平台表使这一点变得具体。 Silverlight 3、4 和 5 是列出的目标； 这三款系统均已于 2021 年停产。列出的系统包括 Windows Phone 7.0、7.5、7.8 和 8.0； 所有这些框架都在 2014 年至 2017 年间停止了支持。剩余的目标框架.NET Framework 3.5、4.0 和 4.5——在 Windows 上仍然具有技术功能，但微软只会提供安全补丁，不会进行任何新功能开发。

实际结果是，MessagingToolkit.Barcode 会阻碍框架现代化。 目标为 net472 且引用此包的项目文件不能在不先删除该包的情况下更改为 net8.0。 该软件包不仅过时，而且还会主动阻止目标框架的更改，而这种更改本可以让项目访问现代.NET功能。

请查阅IronBarcode平台文档，以获取支持的框架和部署目标的完整列表。

IronBarcode方法

IronBarcode支持.NET Framework 4.6.2 至.NET 9，涵盖传统 Windows 应用程序和现代跨平台部署。 一个NuGet包即可安装在所有受支持的平台上，无需单独的图形库或特定于平台的配置。

跨平台支持在实践中意义重大。IronBarcode 的内部镜像管道不依赖于 System.Drawing，后者在 .NET 6 中已仅限于 Windows。面向 Linux 或 macOS 的应用程序（包括运行在 Docker 容器、Linux 版 Azure 应用服务或 AWS Lambda 中的应用程序）使用与 Windows 部署相同的IronBarcodeAPI 和行为。

MessagingToolkit.条形码方法

使用 MessagingToolkit.Barcode 读取需要创建一个 BarcodeDecoder 实例，从图像文件构造一个 Bitmap，将位图传递给 .Decode()，并在访问 .Text 之前检查结果是否为 null。 生成遵循相同的实例模式：创建一个 BarcodeEncoder，设置其 .Format 属性，调用 .Encode() 以接收 Bitmap，然后对该位图调用 .Save()。

// Only compiles on .NET Framework 4.5 or earlier
using MessagingToolkit.Barcode;
using System.Drawing;

// Reading
var barcodeReader = new BarcodeDecoder();
var bitmap = new Bitmap("barcode.png");
var result = barcodeReader.Decode(bitmap);
string value = result?.Text;
string format = result?.BarcodeFormat.ToString();

// Writing
var barcodeWriter = new BarcodeEncoder();
barcodeWriter.Format = BarcodeFormat.QrCode;
var outputBitmap = barcodeWriter.Encode("Hello World");
outputBitmap.Save("output.png");

// Only compiles on .NET Framework 4.5 or earlier
using MessagingToolkit.Barcode;
using System.Drawing;

// Reading
var barcodeReader = new BarcodeDecoder();
var bitmap = new Bitmap("barcode.png");
var result = barcodeReader.Decode(bitmap);
string value = result?.Text;
string format = result?.BarcodeFormat.ToString();

// Writing
var barcodeWriter = new BarcodeEncoder();
barcodeWriter.Format = BarcodeFormat.QrCode;
var outputBitmap = barcodeWriter.Encode("Hello World");
outputBitmap.Save("output.png");

Imports MessagingToolkit.Barcode
Imports System.Drawing

' Reading
Dim barcodeReader As New BarcodeDecoder()
Dim bitmap As New Bitmap("barcode.png")
Dim result = barcodeReader.Decode(bitmap)
Dim value As String = result?.Text
Dim format As String = result?.BarcodeFormat.ToString()

' Writing
Dim barcodeWriter As New BarcodeEncoder()
barcodeWriter.Format = BarcodeFormat.QrCode
Dim outputBitmap = barcodeWriter.Encode("Hello World")
outputBitmap.Save("output.png")

Bitmap 依赖并非偶然。 System.Drawing.Bitmap 需要在 Windows 上安装 GDI+。 在 .NET 6 及更高版本中，尝试在 Linux 或 macOS 上使用 System.Drawing 会在运行时抛出 PlatformNotSupportedException 错误。即使 MessagingToolkit.Barcode 程序集可以在现代 .NET 项目中加载（由于缺少框架目标，实际上无法加载），Bitmap 依赖项仍然会阻止跨平台部署。

IronBarcode方法

IronBarcode全程使用静态方法。 BarcodeReader.Read() 接受文件路径、Stream、字节数组或 PDF 文件路径——不需要 Bitmap。 结果是一个集合，而不是一个可为空的单个对象。 生成过程使用 BarcodeWriter.CreateBarcode()，编码类型作为参数传递，结果对象直接公开保存方法。

// Works on .NET 6, 7, 8, 9 — Windows, Linux, macOS, Docker
using IronBarCode;

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

// Reading
var results = BarcodeReader.Read("barcode.png");
string value = results.FirstOrDefault()?.Value;
string format = results.FirstOrDefault()?.Format.ToString();

// Writing
BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode)
    .SaveAsPng("output.png");

// Works on .NET 6, 7, 8, 9 — Windows, Linux, macOS, Docker
using IronBarCode;

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

// Reading
var results = BarcodeReader.Read("barcode.png");
string value = results.FirstOrDefault()?.Value;
string format = results.FirstOrDefault()?.Format.ToString();

// Writing
BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode)
    .SaveAsPng("output.png");

Imports IronBarCode

' Works on .NET 6, 7, 8, 9 — Windows, Linux, macOS, Docker
IronBarCode.License.LicenseKey = "YOUR-KEY"

' Reading
Dim results = BarcodeReader.Read("barcode.png")
Dim value As String = results.FirstOrDefault()?.Value
Dim format As String = results.FirstOrDefault()?.Format.ToString()

' Writing
BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode) _
    .SaveAsPng("output.png")

有关如何从图像中读取条形码的详细指导，请参阅如何从图像中读取条形码。 要生成包括 Code 128、EAN-13 和 UPC 格式在内的 1D 条形码，请参阅如何创建 1D 条形码。

MessagingToolkit.条形码方法

MessagingToolkit.Barcode 自 2014 年以来就没有收到过任何更新。此后发现的任何漏洞——无论是在库自身的图像解析逻辑中、在其 ZXing 衍生的解码实现中，还是在其传递依赖项中——都将永久未得到修补。 没有维护人员需要通知，没有安全公告流程需要监控，即使开发出了修复程序，也没有发布机制可以将修复程序传递给用户。

安全扫描工具——Snyk、WhiteSource、 GitHub Dependabot、 NuGet audit——将废弃的软件包标记为高风险。 标记并不取决于是否已确认存在 CVE； 这反映出目前没有任何程序可以修复已确认的漏洞。 这与拥有活跃维护者和完善的安全响应流程的库的风险状况截然不同。

对于在合规框架（PCI DSS、HIPAA、SOC 2、ISO 27001）下运营的团队而言，这会产生实际的审计后果。 这些框架需要对第三方软件进行积极的补丁管理。 如果一个废弃的软件包没有漏洞响应机制，无论是否已针对该软件包提交了特定的 CVE 编号，该软件包都将无法通过合规性审计。 审计结果表明不存在可维护的依赖关系，而不是存在已知的漏洞。

IronBarcode方法

IronBarcode会定期收到NuGet更新，内容包括安全补丁、依赖项更新和新功能。 该库由Iron Software开发，该公司维护着完善的支持流程，并为每次更新发布发行说明。 安全公告（如有）会在补丁版本中予以解决。

IronBarcode支持50 多种条形码格式，包括 MessagingToolkit.Barcode 处理的所有格式——QR 码、Code 128、EAN-13、EAN-8、UPC-A 等——以及旧库从未支持的格式：DataMatrix、Aztec、PDF417 和各种现代 2D 条码。

框架现代化要求

最常见的触发因素是计划内或正在进行的.NET升级。 当团队决定将项目从.NET Framework 4.x 迁移到.NET 6 或更高版本时，必须审核依赖关系图，找出缺少现代框架支持的包。 MessagingToolkit.Barcode 将在审核中显示为阻塞依赖项——无法针对现代目标框架名称进行解析。 因此，迁移到IronBarcode是更广泛的.NET升级的先决条件，而不是一项独立的计划。负责应用程序现代化改造的团队通常会在升级分析阶段早期发现这种依赖关系。

安全与合规义务

第二种情况涉及安全审查和合规性审计。 根据 PCI DSS、HIPAA、SOC 2 或 ISO 27001 框架运营的团队会定期接受审核，以检查第三方依赖项的健康状况。 如果一个被遗弃的软件包没有安全响应机制，那么无论是否已发现特定漏洞，该软件包都会因流程问题而无法通过这些审计。 当安全团队将 MessagingToolkit.Barcode 标记为不合规的依赖项时，解决方法是替换——没有补丁可以应用，没有版本可以升级，也没有供应商可以联系以获取安全建议。 迁移到IronBarcode解决了审计发现的问题，方法是将没有维护路径的依赖项替换为定期接收安全更新的依赖项。

能力扩展

第三种情况是，当新的需求超出 MessagingToolkit.Barcode 所能提供的范围时。 处理扫描文档或 PDF 文件的应用程序需要从这些格式中读取条形码——MessagingToolkit.Barcode 只接受位图输入，因此如果没有单独的提取层，就无法读取 PDF。 为网络交付生成条形码的应用程序需要 SVG 或 base64 输出 — MessagingToolkit.Barcode 返回了 Bitmap，需要额外的转换步骤和 System.Drawing.Imaging 依赖项。 当产品需求扩展到这些领域时，旧库的局限性就变成了工程上的限制，无法通过其 API 接口来解决。

平台目标增长

第四种情况是增加新的部署目标。 最初构建仅限 Windows 应用程序的团队，如果扩展到 Linux 托管、macOS 开发环境、Docker 容器或 Linux 运行时上的云函数，则会遇到 System.Drawing 依赖项这一阻塞性问题。 MessagingToolkit.Barcode 需要 System.Drawing.Bitmap 来进行所有输入和输出操作，而 System.Drawing 仅适用于 .NET 6 及更高版本中的 Windows。 任何非 Windows 部署目标都会导致此依赖项出现运行时故障，而不仅仅是兼容性问题。 迁移到IronBarcode完全消除了 System.Drawing 的要求，从而实现了团队正在尝试实现的跨平台部署。

命名空间替换

所有包含 using MessagingToolkit.Barcode; 的文件都需要更新为 using IronBarCode;。 在代码库范围内搜索旧命名空间字符串是确定迁移范围的最可靠起点。 如果导入 System.Drawing 只是为了 MessagingToolkit.Barcode 使用的 Bitmap 类型，那么一旦IronBarcode就位，就可以完全删除该导入，因为IronBarcode不需要它。

目标框架变更

从项目文件中移除 MessagingToolkit.Barcode 可以更新目标框架别名。 一旦阻塞依赖项被移除，从 <TargetFramework>net472</TargetFramework> 到 <TargetFramework>net8.0</TargetFramework> 的更改就成为可能。 IronBarcode支持此更改的两方面——它与.NET Framework 4.6.2 和.NET 8 兼容——因此可以在框架升级完成之前安装它，从而允许分阶段迁移，而不是一步完成。

条形码写入器命名空间差异

MessagingToolkit.Barcode 使用 BarcodeEncoder 作为生成类，并在调用 .Encode() 之前将格式设置为属性 (barcodeWriter.Format = BarcodeFormat.QrCode)。IronBarcode使用 BarcodeWriter.CreateBarcode() 作为静态方法，并将编码类型作为参数传递。 枚举名称有所不同：BarcodeFormat.QrCode 变为 BarcodeEncoding.QRCode，而 BarcodeFormat.Code128 变为 BarcodeEncoding.Code128。 CreateBarcode() 的结果是一个具有 .SaveAsPng()、.SaveAsJpeg()、.SaveAsSvg() 和其他输出方法的流畅对象——它不返回 Bitmap。