C# のデータ マトリックス ジェネレーター - コード例付きの完全なチュートリアル

データマトリックスバーコードの特長とは？

データマトリクスバーコードは、白黒のドットを行と列に並べたグリッドでデータをエンコードする2次元シンボルです。 UPCやEANといった従来の直線型バーコードとは異なり、10×10モジュールという小さなスペースに、最大2,335文字の英数字、または3,116桁の数字を保存できます。 内蔵されたリード・ソロモン式誤り訂正機能により、シンボルの最大30%が破損していても、最新のバーコードスキャナーで正確に読み取ることができます。

これらの特性により、データマトリクスは、医療や物流センターでのラベリングだけでなく、小型部品、郵便バーコード、電子部品のマーキングに最適です。 医療業界では医薬品の追跡にGS1データマトリックス規格が用いられており、製造業者は世界中の製品を識別するために生産ラインにこの規格を組み込んでいる。単一のバーコードに膨大なデータを格納できるため、現在では完全なアプリケーション追跡可能性を求める様々な業界で国際的に利用されている。

ISO/IEC 16022規格はデータマトリックスのエンコーディングを規定しており、 IronBarcodeがデフォルトで使用するECC200バリアントを定義しています。 ECC200は、Data Matrixのどのバージョンよりも効率的なエラー訂正機能と最大のデータ容量を備えているため、新規導入に最適な選択肢となります。

C#プロジェクトにバーコードライブラリをインストールするにはどうすればよいですか？

NuGetパッケージマネージャーを使用すれば、 IronBarcodeのインストールは1分もかかりません。 Visual StudioでPackage Manager Consoleを開き、実行してください：

Install-Package BarCode

または、 NuGetパッケージマネージャーのGUIで、 Iron Software社のBarCodeを検索してください。 インストール後、C#ファイルに名前空間を追加します：

using IronBarCode;

using IronBarCode;

必要な設定は以上です。 IronBarcodeは、ISO/IEC 16022規格に準拠した複雑なデータマトリックスエンコーディングを内部的に処理するため、アプリケーションロジックの開発に集中できます。 オフラインインストールやカスタムパッケージソースなどの追加のセットアップオプションについては、 IronBarcode のインストールガイドおよび高度なNuGetインストールページを参照してください。

データマトリックスバーコードを初めて作成するにはどうすればよいですか？

データマトリックスバーコードを生成するには、たった1行のコードで済みます。

// 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");

このコードは、テキスト"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 メソッドは適切なモジュール比率を維持します。これは、あらゆるスキャナ距離でのデータマトリックスの読み取りに不可欠です。 色の変更は、特殊な印刷工程や、カラーラベルや金属素材などの基材の制約に対応するために行われます。 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);
}

このパターンは、それぞれに固有の識別子が関連付けられた大量のラベルセットを必要とする物流および医療ワークフローに適しています。 ウェブアプリケーションの場合、 PDFドキュメントにバーコードを直接印字するか、バイト配列としてストリーミングすることで、中間ファイルを保存することなくリアルタイムでラベルを生成できます。

データマトリックスバーコードの読み取りと検証方法を教えてください

バーコードの生成はワークフローの半分に過ぎません。スキャナーがバーコードを正しく読み取れることを確認することで、品質管理のサイクルが完了します。IronBarcodeにはバーコードリーダーが内蔵されており、生成した画像を生成後すぐにデコードできます。

// 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.BarcodeType}");
}

// 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.BarcodeType}");
}

この往復検証パターンは、医薬品などの規制産業において特に価値があります。医薬品業界では、 DSCSA規制により、処方薬のパッケージに貼付されたシリアル化されたバーコードが機械で読み取り可能であり、かつ正しい形式であることが義務付けられています。 生成パイプラインの一部として読み戻しチェックを実行することで、ラベルが生産ラインに到達する前にエンコードエラーを検出できます。

より高度な読み取りシナリオについては、 IronBarcodeの読み取りに関するドキュメントおよびPDFからのバーコード読み取りガイドを参照してください。

次のステップは何ですか?

IronBarcodeを使用した C# での Data Matrix バーコード生成は、一貫したパターンに従います。NuGet パッケージをインストールし、 BarcodeWriter.CreateBarcode を BarcodeWriterEncoding.DataMatrix とともに呼び出し、必要なカスタマイズを適用し、ターゲット形式にエクスポートします。 単一のバーコードプロトタイプから大量バッチ処理パイプラインまで、すべて同じAPIで処理できます。

この件をさらに進めるための推奨手順は以下のとおりです。

• バーコード読み取りについて学ぶ： IronBarcodeの読み取りガイドでは、画像、PDF、ライブカメラストリームからバーコードをデコードする方法を解説しています。
• 他の 2D フォーマットもお試しください。IronBarcodeは、同じ API を使用して、 QR コード、PDF417、Aztec、およびすべての主要な 1D フォーマットも生成します。
• ドキュメントにバーコードを埋め込む： PDFスタンプチュートリアルでは、既存のPDFにプログラムでバーコードを追加する方法を示しています。
• 非同期処理によるスケーリング：大規模なバッチジョブを並列化するために、非同期処理とマルチスレッドに関するガイドを参照してください。
• ライセンスの確認：IronBarcodeのライセンスページには、開発者からOEM再配布までのオプションが記載されています。

無料トライアルを開始して、制限なくすべての機能をお試しください。または、 IronBarcodeの完全なドキュメントを参照して、詳細なAPIリファレンスや追加のコード例をご確認ください。

購入の準備ができていませんか？

PM >  Install-Package BarCode

IronBarcode を NuGet でチェックしてください。1000万回以上のダウンロードで、C#によるPDF開発を変革しています。 また、DLLをダウンロードできます。