バーコードの生成は、多くの小売および物流アプリケーションにおいて日常的な作業であり、特にスキャンデバイス用に製品識別コードをエンコードする必要がある場合に重要です。 Aspose.BarCode for .NET は、C# プロジェクトでのバーコード作成を簡素化する堅牢な SDK を提供します。本ガイドでは、EAN-13 バーコードの生成方法、チェックサム処理の設定方法、そして結果を PNG 画像としてエクスポートする手順を、パフォーマンスと保守性のベストプラクティスに従って学びます。
.NETでEAN-13バーコードを作成する手順
- プロジェクトに SDK を追加する - 最新のライブラリを取得するために NuGet コマンド
Install-Package Aspose.BarCodeを実行します。
dotnet add package Aspose.BarCode
- BarcodeGenerator インスタンスの作成 - API リファレンス の
BarcodeGeneratorクラスを使用し、EncodeTypes.EAN13を指定します。
using Aspose.BarCode.Generation;
// Initialize generator with EAN-13 symbology
var generator = new BarcodeGenerator(EncodeTypes.EAN13);
- バーコードの値を設定し、チェックサムを有効にする - 12桁の数字文字列を提供します。
generator.CodeText = "123456789012"; // 12 digits
- バーコードオプションを構成する(オプション) - 必要に応じて BarHeight、色、または余白を調整します。
generator.Parameters.Barcode.XDimension.Pixels = 3;
generator.Parameters.Barcode.BarHeight.Pixels = 150;
generator.Parameters.Barcode.BarColor = Color.Black;
generator.Parameters.BackColor = Color.White;
- バーコードを PNG として保存 -
Saveを呼び出し、目的のファイルパスと形式を指定します。
generator.Save("ean13.png", BarCodeImageFormat.Png);
これらの手順は、.NET 環境で EAN-13 バーコードを生成 機能のコアワークフローをカバーしています。
EAN-13 バーコードサンプル - 完全コード例
次のプログラムは、SDK のインストールから画像生成までのフルエンドツーエンド実装を示しています。
using Aspose.BarCode;
using Aspose.BarCode.Generation;
using Aspose.Drawing;
// Initialize the barcode generator for EAN-13
var generator = new BarcodeGenerator(EncodeTypes.EAN13);
// Set the 12‑digit data; checksum will be added automatically
generator.CodeText = "590123412345";
// Ensure checksum calculation is enabled
generator.Parameters.Barcode.Codabar.ChecksumMode = CodabarChecksumMode.Mod10;
// Optional: customize image appearance
generator.Parameters.Barcode.XDimension.Pixels = 3;
generator.Parameters.Barcode.BarHeight.Pixels = 150;
generator.Parameters.Barcode.BarColor = Color.Black;
generator.Parameters.BackColor = Color.White;
// Set the supplement space in pixels
generator.Parameters.Barcode.Supplement.SupplementSpace.Pixels = 20;
// Set EAN 5 supplement
generator.Parameters.Barcode.Supplement.SupplementData = "12345";
// Save the barcode as a PNG file
generator.Save("D:\\Files\\ean13.png", BarCodeImageFormat.Png);
Console.WriteLine("EAN-13 barcode generated successfully.");

注: このコード例はコア機能を示しています。プロジェクトで使用する前に、ファイルパスを更新し、必要な依存関係がすべてインストールされていることを確認し、開発環境で徹底的にテストしてください。問題が発生した場合は、公式ドキュメントをご参照いただくか、サポートチームにお問い合わせください。
.NET のインストールとセットアップ
- SDK をダウンロード - 最新のバイナリを ダウンロードページ から取得します。
- 参照を追加 - プロジェクトに
Aspose.BarCode.dllを含めるか、NuGet パッケージ (Install-Package Aspose.BarCode) を使用します。 - ライセンスを適用 (本番環境ではオプション) - 開発中は 一時ライセンスページ から一時ライセンスをロードし、本番展開のために 価格ページ からフルライセンスを購入します。
Aspose.BarCode を使用した .NET での EAN-13 バーコードの生成
Aspose.BarCode は、EAN‑13、UPC、QR、DataMatrix など、幅広いシンボルをサポートしています。ライブラリはチェックサム計算、画像レンダリング、フォーマット変換を標準で処理し、信頼性の高い 製品識別コード を必要とするアプリケーションに最適です。
バーコード形式比較
| シンボル | データ長 | チェックサム必要 | 典型的な使用例 |
|---|---|---|---|
| EAN‑13 | 12 桁 (自動計算で13桁目) | はい (自動) | 小売製品ラベル |
| UPC‑A | 11 桁 (自動計算で12桁目) | はい (自動) | 北米小売 |
| QR Code | 可変 | いいえ | モバイル決済、URL |
| DataMatrix | 可変 | いいえ | 小さなアイテムのマーキング |
| Code128 | 可変 | 任意 | 物流、在庫管理 |
Aspose.BarCode このタスクに重要な機能
- 自動チェックサム処理 -
ChecksumMode.Autoを設定し、SDKに最終桁の計算を任せます。 - 高解像度 PNG 出力 - 印刷基準を満たすように画像サイズと DPI を設定します。
- 幅広いフォーマットサポート - 列挙体を1つ変更するだけで他のシンボロジーに切り替えられます。
- スレッドセーフな生成 - 競合なく同時に複数のバーコードインスタンスを作成できます。
パフォーマンスの考慮事項と最適化
- BarcodeGenerator を再利用 同じ設定で多数のバーコードを生成する場合、オブジェクト割り当てのオーバーヘッドを削減します。
- 固定画像解像度を設定 デフォルトに依存せず、不要なスケーリングを回避します。
- バッチ処理 - 大規模カタログ向けに
Parallel.ForEachを使用してバーコードを並列生成し、各スレッドが独自のBarcodeGeneratorインスタンスで動作するようにします。
EAN-13 バーコード生成のベストプラクティス
CodeTextに割り当てる前に、入力文字列が正確に 12 桁の数字であることを常に検証してください。- 手動でチェックサムを計算するのではなく、SDK の組み込みチェックサムモードを使用してください。
- 生成された PNG ファイルは、一貫した命名規則(例:
{ProductId}.png)で保存し、取得を簡素化します。 - パフォーマンス向上やバグ修正の恩恵を受けるため、SDK のバージョンを常に最新に保ってください。
結論
.NET で EAN-13 バーコードを生成するのは、Aspose.BarCode for .NET SDK を使用すれば簡単です。上記の手順に従うことで、アプリケーションにバーコード作成機能をすぐに統合でき、外観をカスタマイズし、最適なパフォーマンスを確保できます。製品版で使用する際は有効なライセンスを適用することを忘れずに、評価中は一時ライセンスページから一時ライセンスを取得し、価格ページでフルライセンスを購入してください。これらのツールがあれば、正確な製品識別コードを埋め込むことがこれまでになく簡単になります。
よくある質問
.NET で Aspose.BarCode を使用して EAN-13 バーコードを生成する方法は?BarcodeGenerator クラスを使用し、EncodeTypes.EAN13 を設定し、12 桁の数値文字列を提供して、PNG 形式で Save を呼び出します。完全なコード例がこのワークフローを示しています。
EAN-13 のデータ長が無効な場合はどうなりますか?
SDK はデータ長が正しくないことを示す ArgumentException をスローします。入力は正確に 12 桁であることを確認してください。13 桁目は自動的に計算されます。
バーコードの色をチェックサムに影響を与えずに変更できますか?
はい。ForeColor と BackColor を任意の Aspose.Drawing.Color に設定します。これらの視覚的な変更は、基になるデータやチェックサムの計算に影響しません。
Aspose.BarCode SDKは大量のバーコード生成に適していますか?
もちろんです。ライブラリはスレッドセーフで、並列処理をサポートしています。BarcodeGenerator インスタンスを再利用し、画像解像度を事前に設定することで、スループットがさらに向上します。
