IronBarcodeを使用して C# でバーコードを生成する方法

NuGetパッケージマネージャーを使用してバーコード生成ライブラリをインストールするにはどうすればよいですか？

Visual Studioを開き、パッケージ・マネージャ・コンソールでこのコマンドを使用してNuGetパッケージをインストールします：

Install-Package BarCode

NuGetパッケージは、.NET 10、 .NET 8、 .NET 6、 .NET Core、 .NET Standard、および.NET Frameworkをサポートしており、Windows アプリケーションおよびクロスプラットフォームの.NETアプリケーションとの互換性があります。 IronBarcodeはDockerコンテナ、Azure、Linuxサーバーへのデプロイをサポートしています。 詳細情報や参考資料については、 IronBarcodeのドキュメントページおよびIron SoftwareのGitHubプロジェクトをご覧ください。

インストール後、プロジェクト内で IronBarCode 名前空間が使用可能になります。 このライブラリは、Windows 上では追加のランタイム依存関係を必要としません。Linux 上では、 IronBarcode Linux 導入ガイドに記載されているように、いくつかのシステムライブラリをインストールする必要がある場合があります。

C#でシンプルなバーコード画像ファイルを生成するにはどうすればよいですか？

わずか数行のコードでバーコード画像を作成します。 次の例は、PNG画像ファイルを保存するBarCode生成です：

using IronBarCode;

// Generate a simple barcode and encode the string data
var barcode = BarcodeWriter.CreateBarcode("SKU-78432-X", BarcodeWriterEncoding.Code128);

// Save the barcode as a PNG image file
barcode.SaveAsPng("product-barcode.png");

using IronBarCode;

// Generate a simple barcode and encode the string data
var barcode = BarcodeWriter.CreateBarcode("SKU-78432-X", BarcodeWriterEncoding.Code128);

// Save the barcode as a PNG image file
barcode.SaveAsPng("product-barcode.png");

BarcodeWriter.CreateBarcode() メソッドは、エンコードする文字列と BarcodeWriterEncoding からのバーコード形式を受け取ります。 返される GeneratedBarcode 参照には、スタイル設定方法と、PNG、JPEG、BMP、TIFF、PDF、または HTML 形式で保存するためのエクスポート オプションが含まれています。

QRコードやその他の2次元バーコードはどのように作成するのですか？

IronBarcodeはQRコードやデータマトリックスなどの2次元バーコードを含む主要なバーコードフォーマットをサポートしています。 同様の構文でQRコードを生成します：

using IronBarCode;

// Create a QR code and encode URL data
var qrCode = BarcodeWriter.CreateBarcode(
    "https://ironsoftware.com/csharp/barcode/",
    BarcodeWriterEncoding.QRCode
);
qrCode.SaveAsPng("website-qr.png");

using IronBarCode;

// Create a QR code and encode URL data
var qrCode = BarcodeWriter.CreateBarcode(
    "https://ironsoftware.com/csharp/barcode/",
    BarcodeWriterEncoding.QRCode
);
qrCode.SaveAsPng("website-qr.png");

QRコードのバーコードタイプは、URLやより大きなデータペイロードの保存に優れています。 このライブラリは、エラー訂正を自動的に処理し、バーコードが部分的に破損していてもスキャン可能であることを保証します。 IronBarcodeはデフォルトではエラー訂正レベルM(中)を使用しており、約15%のデータ損失から回復できます。傷がついたり、部分的に隠れたりする可能性のある印刷済みバーコードの場合は、このレベルをHに上げることができます。

using IronBarCode;

// Generate an EAN-13 barcode compatible with UPC for retail print applications
var eanBarcode = BarcodeWriter.CreateBarcode("5901234123457", BarcodeWriterEncoding.EAN13);
eanBarcode.SaveAsPng("retail-product.png");

using IronBarCode;

// Generate an EAN-13 barcode compatible with UPC for retail print applications
var eanBarcode = BarcodeWriter.CreateBarcode("5901234123457", BarcodeWriterEncoding.EAN13);
eanBarcode.SaveAsPng("retail-product.png");

高度なスタイル設定オプションを使用して、スタイリッシュなQRコードを作成するにはどうすればよいですか？

専門的なバーコード生成には、色を調整したり注釈を追加したりする高度なスタイリングオプションが必要になることがよくあります。 GeneratedBarcode クラスは、スタイリングメソッドを備えた流暢な API を提供します。

using IronBarCode;
using IronSoftware.Drawing;

// Create a styled barcode with advanced styling options
var styledBarcode = BarcodeWriter
    .CreateBarcode("INV-2025-001847", BarcodeWriterEncoding.Code128)
    .ResizeTo(400, 120)
    .SetMargins(20)
    .ChangeBarCodeColor(Color.DarkBlue)
    .AddAnnotationTextAboveBarcode("Invoice Number:")
    .AddBarcodeValueTextBelowBarcode();

// Verify to ensure proper scanning after styling
bool isReadable = styledBarcode.Verify();
Console.WriteLine($"Barcode verification: {(isReadable ? "PASS" : "FAIL")}");
styledBarcode.SaveAsPng("styled-invoice-barcode.png");

using IronBarCode;
using IronSoftware.Drawing;

// Create a styled barcode with advanced styling options
var styledBarcode = BarcodeWriter
    .CreateBarcode("INV-2025-001847", BarcodeWriterEncoding.Code128)
    .ResizeTo(400, 120)
    .SetMargins(20)
    .ChangeBarCodeColor(Color.DarkBlue)
    .AddAnnotationTextAboveBarcode("Invoice Number:")
    .AddBarcodeValueTextBelowBarcode();

// Verify to ensure proper scanning after styling
bool isReadable = styledBarcode.Verify();
Console.WriteLine($"Barcode verification: {(isReadable ? "PASS" : "FAIL")}");
styledBarcode.SaveAsPng("styled-invoice-barcode.png");

流暢なAPIにより、スタイリング・メソッドを連鎖させて、色の調整、余白の設定、テキストの追加を1つのステートメントで行うことができます。 Verify() メソッドは、バーコードが機械で読み取り可能な状態を維持しているかどうかを示します。これにより、標準以外の色を適用したり、小さな寸法にサイズ変更したりした後でも、製造時に適切にスキャンされることが保証されます。

バーコードの色を非常に薄い色に変更したり、白い背景に対してコントラストの低い青色に変更したりすると、バーコードがスキャンできなくなる可能性があります。 色の変更後は必ずVerify()に電話してください。 検証に失敗した場合は、コントラストを上げるか、黒帯表示に​​戻してください。 バーコードのスタイル設定とカスタマイズに関するガイドでは、利用可能なすべてのスタイル設定方法を詳細に解説しています。

カタログ全体で一貫したスタイルで複数のバーコードを生成するには、標準のスタイルチェーンを各 GeneratedBarcode インスタンスに適用するヘルパー メソッドを作成します。 この手法により、生成される数千枚の画像全体で、余白、フォントサイズ、色が均一に保たれます。

バーコードをさまざまな画像形式にエクスポートするにはどうすればよいですか？

さまざまな使用ケースに対応するため、複数のフォーマットでバーコード画像を生成します。 ライブラリは、PNG、JPEG、BMP、TIFF、PDF、HTMLに保存されます：

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("EXPORT-TEST", BarcodeWriterEncoding.Code128);

// Export barcode images to various formats
barcode.SaveAsPng("barcode.png");           // Web-compatible raster image
barcode.SaveAsJpeg("barcode.jpg");          // Compressed format for email attachments
barcode.SaveAsTiff("barcode.tiff");         // High-quality format for print workflows
barcode.SaveAsPdf("barcode.pdf");           // PDF document output
barcode.SaveAsHtmlFile("barcode.html");     // HTML for inline web embedding

// Get as bitmap stream for web APIs or database storage
System.IO.Stream barcodeStream = barcode.ToStream();
System.Drawing.Bitmap bitmapImage = barcode.ToBitmap();

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("EXPORT-TEST", BarcodeWriterEncoding.Code128);

// Export barcode images to various formats
barcode.SaveAsPng("barcode.png");           // Web-compatible raster image
barcode.SaveAsJpeg("barcode.jpg");          // Compressed format for email attachments
barcode.SaveAsTiff("barcode.tiff");         // High-quality format for print workflows
barcode.SaveAsPdf("barcode.pdf");           // PDF document output
barcode.SaveAsHtmlFile("barcode.html");     // HTML for inline web embedding

// Get as bitmap stream for web APIs or database storage
System.IO.Stream barcodeStream = barcode.ToStream();
System.Drawing.Bitmap bitmapImage = barcode.ToBitmap();

ToStream() メソッドは、 ASP.NET Core Web API およびBlazorアプリケーションと互換性のあるバーコード データを返します。 ToBitmap() メソッドは、さらなる画像操作のための System.Drawing.Bitmap 参照を提供します。 既存のPDF文書にバーコードを印字する方法については、 IronBarcodeのPDFバーコードチュートリアルを参照してください。

IronBarcodeはどのようなクロスプラットフォーム.NET環境をサポートしていますか？

IronBarcodeは、主要なすべての.NETプラットフォームにおけるバーコード生成をサポートしています。 配属先

IronBarcodeのDockerセットアップガイドには、コンテナ化されたデプロイメントに必要なシステムライブラリの詳細が記載されています。 Linux 上で実行する場合、通常は libgdiplus と libc6-dev を Docker イメージにインストールする必要があります。 Alpine Linuxでは、若干異なるパッケージセットが必要になります。このガイドでは、Ubuntu/DebianとAlpineの両方のDockerfileについて説明しています。

AWS Lambda のデプロイに関しては、 AWS Lambda デプロイの手順書で、ネイティブ依存関係をデプロイ パッケージにバンドルする方法と、バーコード レンダリングのワークロードを処理するためのメモリ制限を設定する方法について説明しています。

.NETでバーコード生成のベストプラクティスに従うにはどうすればよいですか？

C#アプリケーションでバーコード画像を生成する際に、一貫した手順に従うことで、現場で確実にスキャンできるバーコードと、販売時点情報管理(POS)や倉庫でスキャンに失敗するバーコードとの違いが生まれます。 以下のガイドラインは、どのバーコード形式を選択する場合でも適用されます。

用途に合ったバーコード形式を選択してください。スキャン環境とデータ要件に合致する形式を選びましょう。 URLや80文字を超えるデータにはQRコードを使用してください。 英数字データがコンパクトな直線状の記号に収まる必要がある在庫管理や物流には、コード128を使用してください。 GS1システムへの登録が必要な小売製品には、EAN-13またはUPC-Aを使用してください。 IronBarcodeのバーコードフォーマット比較ページでは、サポートされているすべてのタイプ、それぞれの容量制限、推奨される使用例を並べて比較できます。

必ず十分な静止領域を設けてください。バーコードの周囲の空白部分(静止領域)は、バーコード自体と同じくらい重要です。 スキャナはこれを利用して、シンボルの開始位置と終了位置を検出します。 デジタル表示の場合は各辺に少なくとも10ピクセルのパディングを追加し、印刷出力の場合は少なくとも2.5mmのパディングを追加するには、SetMargins() メソッドを使用してください。 静止領域に侵入することは、生産現場におけるスキャン失敗の最も一般的な原因の一つです。

スタイルを変更した後は必ず確認してください。色の調整、グラデーションの適用、または標準以外の寸法へのサイズ変更を行った後は、GeneratedBarcode オブジェクトに対して Verify() を呼び出してください。 戻り値がfalseの場合、標準のハードウェアではバーコードが確実にスキャンされません。 コントラストを上げるか、スタイルの変更の複雑さを軽減してください。

大量の出力にはバッチ生成パターンを使用してください。アプリケーションが数千個のバーコード(例えば、製品ラベルや出荷明細書など)を生成する場合は、それらをループ処理し、同じスタイル設定を再利用してください。 フォントアセットや設定オブジェクトをループ内で読み込むことは避けてください。不要なオーバーヘッドが発生します。 IronBarcodeのバッチバーコード生成例は、一貫した出力を実現する効率的なループパターンを示しています。

複数のスキャナーモデルと照明条件下でテストを実施してください。バーコードスキャナーは、低コントラストの色に対する耐性、モジュールの小型化、印刷品質などが機種によって異なります。 印刷したバーコードは、展開前に少なくとも2種類の異なるスキャナーでテストしてください。 画面に表示されるQRコードについては、明るい場所と暗い場所の両方で、携帯電話のカメラを使ってテストしてください。 GS1バーコード検証規格のページには、小売用バーコードのシンボル品質等級付けに関する権威あるガイダンスが掲載されています。

データ容量制限を遵守してください。すべてのバーコード形式には最大データ容量が設定されています。 Code 128では、標準的なラベルサイズで印刷するには記号が幅広すぎる前に、約48文字まで快適にエンコードできます。 QRコードの容量は誤り訂正レベルによって異なり、レベルHでは最大で約1,273文字の英数字が記録可能です。 容量を超過すると、ライブラリは例外をスローするか、あるいは黙って品質を低下させるかのどちらかを選択せざるを得なくなります。 容量を簡単に確認するには、 WikipediaのQRコードデータ容量に関する項目を参照してください。

.NET の破棄パターンに従ってください。 GeneratedBarcode および ToStream() によって返されるストリームは、IDisposable を実装します。 特にリクエストごとにバーコード生成が行われる高スループットのWebアプリケーションでは、アンマネージド リソースを迅速に解放するために、それらを using ステートメントで囲みます。

一般的な障害モードを理解することは、より堅牢な生成コードを構築する上でも役立ちます。 スキャン失敗の最も一般的な原因は、静止領域が不十分であること、バーの色が背景色に近すぎること、およびバーコードが選択したフォーマットの最小モジュールサイズよりも小さく縮小されていることです。 IronBarcode の Verify() メソッドは、実行時に 3 つすべてを捕捉します。

生成された画像からバーコードを読み取る方法(往復テストやアップロードされたファイルのスキャンなど)については、 IronBarcodeバーコードリーダーガイドを参照してください。 リーダーAPIは、シンプルさという点でライターAPIを模倣しており、同様に幅広いフォーマットをサポートしています。

IronBarcodeが準拠する技術仕様は、Code 128に関するISO/IEC 15417規格とQRコードに関するISO/IEC 18004規格によって規定されています。 対象となるバーコードの種類に関連する規格を確認することで、図書館が遵守しなければならない制約を理解するのに役立ちます。

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

このガイドでは、 IronBarcodeを使用して C# でバーコード画像を生成する方法について説明しました。NuGetのインストールから、Code 128、QR コード、EAN-13 の生成、流暢な API を使用した高度なスタイリング、マルチフォーマットのエクスポート、クロスプラットフォーム展開、本番環境でのベストプラクティスまでを網羅しています。

さらに詳しく知りたい場合は、以下のリソースをご覧ください。

• IronBarcode の完全な API リファレンス-- GeneratedBarcode、およびすべての列挙型の完全なメソッドドキュメント
• IronBarcodeバーコードリーダーチュートリアル- 画像、PDF、ストリームからバーコードを読み取り、デコードする方法 -バッチバーコード生成の例- ラベル印刷および出荷ワークフロー向けの大量生成パターン -IronBarcodeのライセンスと価格設定-- オプションは$799から始まります

IronBarcodeをダウンロードして、 .NETアプリケーションにバーコード機能を追加するか、ライセンスキーなしで環境内でバーコード画像を生成できる30日間の無料トライアルを開始してください。