C# 数据矩阵生成器——包含代码示例的完整教程

数据矩阵条形码有何特别之处？

数据矩阵条形码是二维符号，它将数据编码到排列成行和列的黑白点阵网格中。 与传统的线性条形码（如 UPC 或 EAN）不同，它们可以在 10 x 10 个模块大小的空间内存储多达 2,335 个字母数字字符或 3,116 个数字。 由于内置的​​里德-所罗门纠错功能，即使符号损坏高达 30%，现代条形码扫描器也能准确读取它们。

这些特性使得 Data Matrix 成为标记小型零件、邮政条形码和电子元件的理想选择，也适用于医疗保健和物流中心的标签制作。 医疗保健行业依赖GS1数据矩阵标准进行药品追踪，而制造商则将其嵌入生产线，用于在全球范围内识别产品。由于单个条形码可以存储大量数据，因此如今已被国际上各个行业广泛采用，以实现完整的应用追溯。

ISO/IEC 16022 标准规范了数据矩阵编码，定义了IronBarcode默认使用的 ECC200 变体。 ECC200 提供所有 Data Matrix 版本中最有效的纠错能力和最大的数据容量，使其成为新部署的正确选择。

如何在 C# 项目中安装条形码库？

使用NuGet包管理器安装IronBarcode只需不到一分钟。 在 Visual Studio 中打开软件包管理器控制台并运行：

Install-Package BarCode

或者，在NuGet包管理器 GUI 中搜索Iron Software的BarCode 。 安装完成后，将命名空间添加到您的 C# 文件中：

using IronBarCode;

using IronBarCode;

这就是全部的准备工作了。 IronBarcode按照 ISO/IEC 16022 标准在内部处理所有复杂的 Data Matrix 编码，因此您可以专注于应用程序逻辑。 有关离线安装或自定义包源等其他设置选项，请参阅IronBarcode安装指南和高级NuGet安装页面。

如何创建您的第一个数据矩阵条形码？

生成 Data Matrix 条形码只需要一行代码：

// Create a Data Matrix barcode with product information
var myBarcode = BarcodeWriter.CreateBarcode("PROD-12345-2024", BarcodeWriterEncoding.DataMatrix);

// Save as a high-quality PNG image
myBarcode.SaveAsImage("product-label.png");

// Create a Data Matrix barcode with product information
var myBarcode = BarcodeWriter.CreateBarcode("PROD-12345-2024", BarcodeWriterEncoding.DataMatrix);

// Save as a high-quality PNG image
myBarcode.SaveAsImage("product-label.png");

这段代码会创建一个数据矩阵条形码，编码文本为 PROD-12345-2024，并将其保存为 PNG 文件。参数 BarcodeWriterEncoding.DataMatrix 指示IronBarcode使用数据矩阵格式。 生成的条形码会自动应用 ECC200 规范，该规范包含内置纠错功能，可确保在实际条件下可靠扫描。

// Get barcode as a bitmap for direct display in a UI control
var barcodeBitmap = myBarcode.ToBitmap();

// Save as PDF for document integration
myBarcode.SaveAsPdf("barcode-document.pdf");

// Get barcode as a bitmap for direct display in a UI control
var barcodeBitmap = myBarcode.ToBitmap();

// Save as PDF for document integration
myBarcode.SaveAsPdf("barcode-document.pdf");

数据矩阵条形码可以编码哪些数据类型？

Data Matrix 支持多种编码模式，每种模式都针对不同的字符集进行了优化。 IronBarcode会根据您提供的内容自动选择最高效的模式：

// Encode alphanumeric product codes
var productCode = BarcodeWriter.CreateBarcode("ABC-123-XYZ", BarcodeWriterEncoding.DataMatrix);
productCode.SaveAsImage("product-code.png");

// Encode numeric serial numbers (numeric mode uses less space)
var serialNumber = BarcodeWriter.CreateBarcode("987654321098765", BarcodeWriterEncoding.DataMatrix);
serialNumber.SaveAsImage("serial-number.png");

// Encode URLs for product landing pages or support portals
var urlCode = BarcodeWriter.CreateBarcode("https://example.com/product/12345", BarcodeWriterEncoding.DataMatrix);
urlCode.SaveAsImage("url-datamatrix.png");

// Encode Unicode text for international applications
var unicodeBarcode = BarcodeWriter.CreateBarcode("製品-2024-東京", BarcodeWriterEncoding.DataMatrix);
unicodeBarcode.SaveAsImage("unicode-datamatrix.png");

// Encode alphanumeric product codes
var productCode = BarcodeWriter.CreateBarcode("ABC-123-XYZ", BarcodeWriterEncoding.DataMatrix);
productCode.SaveAsImage("product-code.png");

// Encode numeric serial numbers (numeric mode uses less space)
var serialNumber = BarcodeWriter.CreateBarcode("987654321098765", BarcodeWriterEncoding.DataMatrix);
serialNumber.SaveAsImage("serial-number.png");

// Encode URLs for product landing pages or support portals
var urlCode = BarcodeWriter.CreateBarcode("https://example.com/product/12345", BarcodeWriterEncoding.DataMatrix);
urlCode.SaveAsImage("url-datamatrix.png");

// Encode Unicode text for international applications
var unicodeBarcode = BarcodeWriter.CreateBarcode("製品-2024-東京", BarcodeWriterEncoding.DataMatrix);
unicodeBarcode.SaveAsImage("unicode-datamatrix.png");

数字数据采用紧凑的编码模式，与字母数字文本相比，可减小条形码尺寸。 二进制编码无需手动配置即可处理特殊字符和Unicode文本。 IronBarcode会自动选择最有效的编码模式，因此您无需明确指定。

如何自定义数据矩阵条形码的外观？

IronBarcode提供了一整套条形码自定义选项，用于控制尺寸、颜色、注释和边距：

// Create barcode with custom styling
var customBarcode = BarcodeWriter.CreateBarcode("CUSTOM-2024", BarcodeWriterEncoding.DataMatrix);

// Set specific dimensions in pixels
customBarcode.ResizeTo(500, 500);

// Adjust colors for special label requirements
customBarcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.DarkBlue);
customBarcode.ChangeBackgroundColor(IronSoftware.Drawing.Color.LightGray);

// Add human-readable text below the barcode symbol
customBarcode.AddAnnotationTextBelowBarcode("Product: CUSTOM-2024");

// Set margins to preserve the required quiet zone
customBarcode.SetMargins(10);

customBarcode.SaveAsImage("custom-datamatrix.png");

// Create barcode with custom styling
var customBarcode = BarcodeWriter.CreateBarcode("CUSTOM-2024", BarcodeWriterEncoding.DataMatrix);

// Set specific dimensions in pixels
customBarcode.ResizeTo(500, 500);

// Adjust colors for special label requirements
customBarcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.DarkBlue);
customBarcode.ChangeBackgroundColor(IronSoftware.Drawing.Color.LightGray);

// Add human-readable text below the barcode symbol
customBarcode.AddAnnotationTextBelowBarcode("Product: CUSTOM-2024");

// Set margins to preserve the required quiet zone
customBarcode.SetMargins(10);

customBarcode.SaveAsImage("custom-datamatrix.png");

这些定制化服务有助于满足企业品牌推广要求或特定标签标准。 ResizeTo 方法保持了正确的模块比例，这对于在任何扫描仪距离下 Data Matrix 的可读性至关重要。 颜色变化是为了适应特殊的印刷工艺或承印物限制，例如彩色标签或金属材料。 SetMargins 设置的静默区裕度满足 ISO/IEC 16022 规范中定义的最小空白要求。

如何批量生成多个条形码？

批量生成功能减少了创建大量数据矩阵码(用于生产运行、运输标签或序列化库存)所需的工作量：

// Generate barcodes for a batch of products
string[] productIds = { "PROD-001", "PROD-002", "PROD-003", "PROD-004", "PROD-005" };

foreach (string id in productIds)
{
    var batchBarcode = BarcodeWriter.CreateBarcode(id, BarcodeWriterEncoding.DataMatrix);
    batchBarcode.ResizeTo(150, 150);
    batchBarcode.AddAnnotationTextBelowBarcode(id);

    // Save each barcode with a unique filename
    string filename = $"barcode_{id.Replace("-", "_")}.png";
    batchBarcode.SaveAsImage(filename);
}

// Generate barcodes for a batch of products
string[] productIds = { "PROD-001", "PROD-002", "PROD-003", "PROD-004", "PROD-005" };

foreach (string id in productIds)
{
    var batchBarcode = BarcodeWriter.CreateBarcode(id, BarcodeWriterEncoding.DataMatrix);
    batchBarcode.ResizeTo(150, 150);
    batchBarcode.AddAnnotationTextBelowBarcode(id);

    // Save each barcode with a unique filename
    string filename = $"barcode_{id.Replace("-", "_")}.png";
    batchBarcode.SaveAsImage(filename);
}

这种模式适用于需要大量标签集的物流和医疗保健工作流程，每个标签集都与一个唯一的标识符相关联。 对于 Web 应用程序，直接在 PDF 文档上添加条形码或将其作为字节数组进行流式传输，可以实现实时标签生成，而无需保存中间文件。

如何读取和验证数据矩阵条形码？

生成条形码只是工作流程的一半——验证扫描器能否正确读取条形码才是质量控制闭环的最后一步。IronBarcodeIronBarcode条形码读取器，可让您在生成条形码后立即对其进行解码：

// Generate a barcode
var generated = BarcodeWriter.CreateBarcode("VERIFY-2024", BarcodeWriterEncoding.DataMatrix);
generated.SaveAsImage("verify-test.png");

// Read it back to confirm correct encoding
var results = BarcodeReader.Read("verify-test.png");
foreach (var result in results)
{
    Console.WriteLine($"Decoded value: {result.Value}");
    Console.WriteLine($"翻译格式: {result.Barcode翻译类型}");
}

// Generate a barcode
var generated = BarcodeWriter.CreateBarcode("VERIFY-2024", BarcodeWriterEncoding.DataMatrix);
generated.SaveAsImage("verify-test.png");

// Read it back to confirm correct encoding
var results = BarcodeReader.Read("verify-test.png");
foreach (var result in results)
{
    Console.WriteLine($"Decoded value: {result.Value}");
    Console.WriteLine($"翻译格式: {result.Barcode翻译类型}");
}

这种往返验证模式在受监管的行业(例如制药行业)中尤其有价值，因为《药品供应链安全法案》(DSCSA) 规定处方药包装上的序列化条形码必须既是机器可读的，又是格式正确的。 在生成流程中运行回读检查，可以在标签到达生产线之前捕获编码错误。

对于更高级的读取场景，请参阅IronBarcode读取文档和从 PDF 读取条形码指南。

下一步计划是什么？

使用IronBarcode在 C# 中生成 Data Matrix 条形码遵循一致的模式：安装NuGet包，调用 BarcodeWriter.CreateBarcode 和 BarcodeWriterEncoding.DataMatrix，应用任何所需的自定义项，然后导出为目标格式。 同一个 API 可以处理从单个条形码原型到大批量流水线的所有操作。

以下是进一步推进此项目的推荐路径：

-探索条形码读取： IronBarcode读取指南涵盖了从图像、PDF 和实时摄像头流中解码条形码。 -尝试其他 二维 格式： IronBarcode还使用相同的 API 生成QR 码、PDF417、Aztec 和所有主要的 1D 格式。 -在文档中嵌入条形码： PDF 盖章教程展示了如何以编程方式向现有 PDF 添加条形码。 -利用异步处理进行扩展：查看异步和多线程指南，以并行化大型批处理作业。 -查看许可：IronBarcode许可页面列出了从开发者到 OEM 再分发的各种选项。

开始免费试用，即可不受限制地测试所有功能，或者查看完整的IronBarcode文档，获取详细的 API 参考和其他代码示例。

使用 NuGet 安装

PM >  Install-Package BarCode

在 IronBarcode 上查看 NuGet 快速安装。超过 1000 万次下载，它正以 C# 改变 PDF 开发。 您也可以下载 DLL。