C# 文字列からバーコードを生成する：IronBarcodeによる完全なチュートリアル

IronBarcodeを.NETプロジェクトにインストールするにはどうすればよいですか？

IronBarcodeのインストールは、.NET CLIまたはVisual Studio内のNuGetパッケージマネージャーを使用すれば、数秒で完了します。

オプション1 - .NET CLI（ .NET 10に推奨）：

dotnet add package Barcode

dotnet add package Barcode

オプション2 - Visual StudioのNuGetパッケージマネージャーコンソール：

Install-Package BarCode

または、 NuGetパッケージマネージャーのGUIで" IronBarcode "を検索し、公式パッケージをインストールしてください。 このライブラリは、.NET Framework 4.6.2以降および.NET 5から.NET 10までを対象としており、最新の.NETワークロードとの互換性を確保しています。

インストール後、バーコードを生成または読み取る各ファイルの先頭に、using ディレクティブを1つ追加してください。

using IronBarCode;

using IronBarCode;

このディレクティブは、BarcodeEncoding、およびこのガイドで説明されているその他の公開型を公開します。

C#で文字列からシンプルなバーコードを生成するにはどうすればよいですか？

BarcodeWriter.CreateBarcode メソッドは、バーコード生成のエントリポイントです。 エンコードしたい文字列と BarcodeEncoding 値を一緒に渡すと、保存やさらなる操作が可能な GeneratedBarcode オブジェクトが返されます。

using IronBarCode;

// Generate a Code 128 barcode from a product SKU string
string productCode = "SKU-78432-A";
var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128);
barcode.SaveAsPng("product_barcode.png");

using IronBarCode;

// Generate a Code 128 barcode from a product SKU string
string productCode = "SKU-78432-A";
var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128);
barcode.SaveAsPng("product_barcode.png");

using IronBarCode;

// Specify width and height in pixels for the barcode image
string productCode = "SKU-78432-A";
var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128, 400, 120);
barcode.SaveAsPng("product_barcode_sized.png");

using IronBarCode;

// Specify width and height in pixels for the barcode image
string productCode = "SKU-78432-A";
var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128, 400, 120);
barcode.SaveAsPng("product_barcode_sized.png");

IronBarcodeはどのようなバーコードフォーマットをサポートしていますか？

IronBarcodeは、さまざまな用途に対応するため、20種類以上のバーコードタイプをサポートしています。 適切なフォーマットを選択することで、スキャンが正しく行われ、アプリケーションに必要なデータ容量が確保されます。

using IronBarCode;

string url = "https://ironsoftware.com/csharp/barcode/";
string numericId = "0123456789012";

// QR Code -- best for URLs, text data, and mobile scanning
BarcodeWriter.CreateBarcode(url, BarcodeEncoding.QRCode)
    .SaveAsPng("qrcode.png");

// UPC-A -- required for retail point-of-sale systems (12 digits)
BarcodeWriter.CreateBarcode(numericId, BarcodeEncoding.UPCA)
    .SaveAsPng("upc_barcode.png");

// PDF417 -- suited for documents that need higher data capacity
BarcodeWriter.CreateBarcode("Extended product details here", BarcodeEncoding.PDF417)
    .SaveAsJpeg("pdf417_barcode.jpeg");

using IronBarCode;

string url = "https://ironsoftware.com/csharp/barcode/";
string numericId = "0123456789012";

// QR Code -- best for URLs, text data, and mobile scanning
BarcodeWriter.CreateBarcode(url, BarcodeEncoding.QRCode)
    .SaveAsPng("qrcode.png");

// UPC-A -- required for retail point-of-sale systems (12 digits)
BarcodeWriter.CreateBarcode(numericId, BarcodeEncoding.UPCA)
    .SaveAsPng("upc_barcode.png");

// PDF417 -- suited for documents that need higher data capacity
BarcodeWriter.CreateBarcode("Extended product details here", BarcodeEncoding.PDF417)
    .SaveAsJpeg("pdf417_barcode.jpeg");

C#でバーコード画像をカスタマイズおよびスタイル設定するにはどうすればよいですか？

IronBarcodeは、基本的なバーコード生成機能に加え、外部の画像処理ライブラリを使用することなく、色調整、注釈の追加、バーコード画像のサイズ変更などを行うための流暢なスタイリングAPIを提供しています。

using IronBarCode;
using IronSoftware.Drawing;

string orderNumber = "ORD-2024-00542";
var styledBarcode = BarcodeWriter.CreateBarcode(orderNumber, BarcodeEncoding.Code128);

// Adjust colors to match brand identity
styledBarcode.ChangeBarCodeColor(Color.DarkBlue);
styledBarcode.ChangeBackgroundColor(Color.White);

// Add readable text annotations above and below the bars
styledBarcode.AddAnnotationTextAboveBarcode("Order Number", new Font("Arial", 12), Color.Black, 5);
styledBarcode.AddBarcodeValueTextBelowBarcode(new Font("Arial", 10), Color.Gray, 5);

// Resize to fit a thermal label at 400 x 150 pixels
styledBarcode.ResizeTo(400, 150);
styledBarcode.SaveAsPng("styled_order_barcode.png");

using IronBarCode;
using IronSoftware.Drawing;

string orderNumber = "ORD-2024-00542";
var styledBarcode = BarcodeWriter.CreateBarcode(orderNumber, BarcodeEncoding.Code128);

// Adjust colors to match brand identity
styledBarcode.ChangeBarCodeColor(Color.DarkBlue);
styledBarcode.ChangeBackgroundColor(Color.White);

// Add readable text annotations above and below the bars
styledBarcode.AddAnnotationTextAboveBarcode("Order Number", new Font("Arial", 12), Color.Black, 5);
styledBarcode.AddBarcodeValueTextBelowBarcode(new Font("Arial", 10), Color.Gray, 5);

// Resize to fit a thermal label at 400 x 150 pixels
styledBarcode.ResizeTo(400, 150);
styledBarcode.SaveAsPng("styled_order_barcode.png");

データベースデータから複数のバーコードを生成するにはどうすればよいですか？

実際のアプリケーションでは、製品カタログ、在庫補充、注文発送ワークフローなど、複数のアイテムの集合体に対してバーコードを生成する必要が生じることがよくあります。 IronBarcodeは、追加の設定なしでバッチ処理に対応します。

using IronBarCode;

// Data sourced from a database query result
List<string> productIds =
[
    "PROD-001-X",
    "PROD-002-Y",
    "PROD-003-Z",
    "PROD-004-W"
];

// Generate one barcode image per product ID
foreach (string productId in productIds)
{
    var barcode = BarcodeWriter.CreateBarcode(productId, BarcodeEncoding.Code128, 300, 100);
    barcode.SaveAsPng($"barcodes/{productId}.png");
}

using IronBarCode;

// Data sourced from a database query result
List<string> productIds =
[
    "PROD-001-X",
    "PROD-002-Y",
    "PROD-003-Z",
    "PROD-004-W"
];

// Generate one barcode image per product ID
foreach (string productId in productIds)
{
    var barcode = BarcodeWriter.CreateBarcode(productId, BarcodeEncoding.Code128, 300, 100);
    barcode.SaveAsPng($"barcodes/{productId}.png");
}

バーコードをさまざまなファイル形式で保存およびエクスポートするにはどうすればよいですか？

GeneratedBarcode は、ビジネスアプリケーションでよく使用される画像フォーマットを網羅するさまざまな保存方法を提供します。

using IronBarCode;

string value = "EXPORT-TEST-001";
var barcode = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128, 400, 120);

// Save to disk in multiple formats
barcode.SaveAsPng("barcode.png");       // Lossless -- best for print
barcode.SaveAsJpeg("barcode.jpg");      // Compressed -- smaller file size
barcode.SaveAsGif("barcode.gif");       // Compatible with legacy systems
barcode.SaveAsTiff("barcode.tiff");     // Multi-page archival format
barcode.SaveAsBmp("barcode.bmp");       // Uncompressed bitmap

// Export as a byte array for in-memory operations (API responses, database storage)
byte[] pngBytes = barcode.ToStream(ImageFormat.Png).ToArray();

using IronBarCode;

string value = "EXPORT-TEST-001";
var barcode = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128, 400, 120);

// Save to disk in multiple formats
barcode.SaveAsPng("barcode.png");       // Lossless -- best for print
barcode.SaveAsJpeg("barcode.jpg");      // Compressed -- smaller file size
barcode.SaveAsGif("barcode.gif");       // Compatible with legacy systems
barcode.SaveAsTiff("barcode.tiff");     // Multi-page archival format
barcode.SaveAsBmp("barcode.bmp");       // Uncompressed bitmap

// Export as a byte array for in-memory operations (API responses, database storage)
byte[] pngBytes = barcode.ToStream(ImageFormat.Png).ToArray();

適切なフォーマットの選択は、最終消費者のニーズによって決まります。 PNGは、印刷用のラベルや文書に適しています。 JPEGは、ストレージ容量が制約となる用途に適しています。 PDF文書にバーコードを直接埋め込むために、 IronBarcodeはIronPDFと連携し、プログラムによってバーコード画像をスタンプまたは挿入します。

ToStream オーバーロードは、ディスクへの書き込みが望ましくない Web API やクラウド関数で特に役立ちます。 バイト配列は、データベースのBLOB列に格納したり、クラウドストレージにアップロードしたり、ファイルシステム上の中間ファイルを経由せずにHTTPレスポンスに直接ストリーミングしたりできます。

エンコード前に文字列データを検証するにはどうすればよいですか？

すべての文字列がすべてのバーコード形式に対して有効であるとは限りません。 UPC-Aは正確に12桁の数字を必要とし、EAN-13は13桁を必要とします。また、一部の1次元フォーマットでは、限られたASCIIサブセット以外の文字は拒否されます。 無効なデータを CreateBarcode に渡すと、IronBarCodeEncodingException が発生します。 呼び出しをtry/catchブロックで囲み、入力値を事前に検証することで、本番環境での未処理例外を防ぐことができます。

using IronBarCode;

bool TryCreateBarcode(string value, BarcodeEncoding encoding, string outputPath)
{
    if (string.IsNullOrWhiteSpace(value))
    {
        Console.WriteLine("Value must not be empty.");
        return false;
    }

    try
    {
        var barcode = BarcodeWriter.CreateBarcode(value, encoding);
        barcode.SaveAsPng(outputPath);
        return true;
    }
    catch (IronBarCodeEncodingException ex)
    {
        Console.WriteLine($"Encoding failed: {ex.Message}");
        return false;
    }
}

// Usage
TryCreateBarcode("SKU-001", BarcodeEncoding.Code128, "output.png");   // succeeds
TryCreateBarcode("NOT-NUMERIC", BarcodeEncoding.UPCA, "output.png");  // encoding exception

using IronBarCode;

bool TryCreateBarcode(string value, BarcodeEncoding encoding, string outputPath)
{
    if (string.IsNullOrWhiteSpace(value))
    {
        Console.WriteLine("Value must not be empty.");
        return false;
    }

    try
    {
        var barcode = BarcodeWriter.CreateBarcode(value, encoding);
        barcode.SaveAsPng(outputPath);
        return true;
    }
    catch (IronBarCodeEncodingException ex)
    {
        Console.WriteLine($"Encoding failed: {ex.Message}");
        return false;
    }
}

// Usage
TryCreateBarcode("SKU-001", BarcodeEncoding.Code128, "output.png");   // succeeds
TryCreateBarcode("NOT-NUMERIC", BarcodeEncoding.UPCA, "output.png");  // encoding exception

文字列値からバーコードを読み取るにはどうすればよいですか？

多くのシステムにおいて、バーコードの生成はワークフローの半分に過ぎない。 バーコード読み取りAPIは、BarcodeReader.Readを使用して画像を元の文字列にデコードします。

using IronBarCode;

// Read all barcodes from an image file
var results = BarcodeReader.Read("product_barcode.png");

foreach (var result in results)
{
    // Output the decoded string value
    Console.WriteLine($"Decoded value: {result.Value}");
    Console.WriteLine($"形式 detected: {result.BarcodeType}");
}

using IronBarCode;

// Read all barcodes from an image file
var results = BarcodeReader.Read("product_barcode.png");

foreach (var result in results)
{
    // Output the decoded string value
    Console.WriteLine($"Decoded value: {result.Value}");
    Console.WriteLine($"形式 detected: {result.BarcodeType}");
}

これにより、往復バーコードワークフローを簡単に構築できます。つまり、製品レコードからバーコードを生成し、ディスクまたはラベルプリンターのキューに保存し、後で物理的なラベルをスキャンして値をデコードし、レコードを検索します。 IronBarcodeは、 PDFファイルやライブカメラ映像からバーコードを読み取るための専用メソッドを、同じように分かりやすいAPIで提供しています。

ASP.NET Core Web APIでIronBarcodeを使用するにはどうすればよいでしょうか？

IronBarcodeは、ASP.NET Coreコントローラーと最小限のAPIハンドラー内で動作します。 最も一般的なパターンは、バーコード画像をファイルとして返すか、ブラウザでレンダリングするためのbase64エンコードされたデータURIを返す。

using IronBarCode;
using Microsoft.AspNetCore.Mvc;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// Minimal API endpoint -- returns a barcode PNG for the given value
app.MapGet("/barcode/{value}", (string value) =>
{
    var barcode = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128, 400, 120);
    byte[] imageBytes = barcode.ToStream(ImageFormat.Png).ToArray();
    return Results.File(imageBytes, "image/png");
});

app.Run();

using IronBarCode;
using Microsoft.AspNetCore.Mvc;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// Minimal API endpoint -- returns a barcode PNG for the given value
app.MapGet("/barcode/{value}", (string value) =>
{
    var barcode = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128, 400, 120);
    byte[] imageBytes = barcode.ToStream(ImageFormat.Png).ToArray();
    return Results.File(imageBytes, "image/png");
});

app.Run();

このエンドポイントは、URLパスで渡された任意の値に対して、必要に応じてバーコードを生成します。 本番環境への導入においては、同じバーコード値に対するリクエストが繰り返されても画像が再生成されないように、キャッシュ機能を追加してください。 依存性注入やレスポンスキャッシュなど、より詳細な手順については、 ASP.NETバーコード生成チュートリアル全文をご覧ください。

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

IronBarcodeを使えば、C#で文字列データからバーコードを生成するのは簡単です。 流暢なAPIは、バーコードエンコードの複雑さを処理すると同時に、カスタマイズやバッチ処理のための柔軟性も提供します。 在庫管理用のシンプルなCode 128バーコードであれ、モバイルアプリケーション用のQRコードであれ、 IronBarcodeは.NETアプリケーション向けに信頼性の高いバーコード機能を提供します。

さらに詳しく知りたい場合は：

IronBarcodeをダウンロードし、このガイドのコードサンプルをローカルで実行してください。

• 本番環境への導入にはライセンスを購入してください。ライセンスには無料トライアル期間が含まれています。 APIリファレンス、高度な設定、プラットフォーム固有の注意事項については、ドキュメントを参照してください。 QRコード生成、バーコードスキャン、PDF統合などに関するコード例をご覧ください。
• ASP.NETバーコード統合- MVC ビューとRazor Pages でバーコードを表示するための完全ガイド
• バーコードスキャナーとの連携- C# で画像、PDF、USB スキャナーからバーコードを読み取ります

今IronBarcodeを始めましょう。

無料で始める