平台和维护记录

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 阻碍了框架的升级。 无法在不首先移除该包的情况下，将一个针对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 App Service或AWS Lambda——使用与Windows部署相同的IronBarcode API和行为。

MessagingToolkit.条形码方法

使用MessagingToolkit.Barcode进行读取需要创建一个.Text之前检查结果是否为空。 生成遵循相同的实例模式：创建一个.Save()。

// MessagingToolkit.Barcode — .NET Framework target frameworks
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");

// MessagingToolkit.Barcode — .NET Framework target frameworks
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需要GDI+在Windows上。 在.NET 6及更高版本中，尝试在Linux或macOS上使用Bitmap依赖将阻止跨平台部署。

IronBarcode方法

IronBarcode全程使用静态方法。 Bitmap。 结果是一个集合，而不是一个可为空的单个对象。 生成使用BarcodeWriter.CreateBarcode()作为参数传递的编码类型，结果对象直接公开保存方法。

//IronBarcode— .NET Framework 4.6.2 through .NET 9
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-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");

//IronBarcode— .NET Framework 4.6.2 through .NET 9
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-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

IronBarCode.License.LicenseKey = "YOUR-LICENSE-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.条形码方法

自2013 年4月以来， MessagingToolkit.Barcode没有收到任何更新。 任何在该日期之后发现的漏洞——不论是在库本身的图像解析逻辑中，还是在其源自ZXing的解码实现中，还是在其传递性依赖关系中——都未被修补。 没有公共维护者可以通知，没有安全咨询流程可以监控，并且即使开发了漏洞修复，通过发布机制也没有传达给用户的方法。

安全扫描工具 —— Snyk、WhiteSource、GitHub Dependabot、NuGet审计 —— 通常将未维护的包标记为风险升高。 标记并不取决于是否已确认存在 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返回System.Drawing.Imaging依赖。 当产品需求扩展到这些领域时，旧库的局限性就变成了工程上的限制，无法通过其 API 接口来解决。

平台目标增长

第四种情况是增加新的部署目标。 最初构建Windows应用程序并扩展到Linux托管、macOS开发环境、Docker容器或在Linux运行时上的云函数的团队会发现System.Drawing依赖是个障碍问题。 MessagingToolkit.Barcode需要System.Drawing在.NET 6及以上版本中仅限Windows。 任何非 Windows 部署目标都会导致此依赖项出现运行时故障，而不仅仅是兼容性问题。 迁移到IronBarcode彻底消除了System.Drawing要求，实现团队试图实现的跨平台部署。

命名空间替换

每个包含using IronBarCode;。 在代码库范围内搜索旧命名空间字符串是确定迁移范围的最可靠起点。 仅为与MessagingToolkit.Barcode一起使用的System.Drawing的文件可能在IronBarcode就位后完全删除该导入，因为IronBarcode不需要它。

目标框架变更

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

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

MessagingToolkit.Barcode使用barcodeWriter.Format = BarcodeFormat.QrCode）。 IronBarcode使用BarcodeWriter.CreateBarcode()作为静态方法，编码类型作为参数传递。 枚举名称不同：BarcodeEncoding.Code128。 Bitmap。