ASP.NET Core Web アプリでバーコードを生成する

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

ASP.NET Core Webアプリケーションにバーコード生成機能を追加するには、 IronBarcode NuGetパッケージをインストールする必要があります。 Visual Studioを開き、パッケージ・マネージャ・コンソールを使って依存関係をインストールしてください：

Install-Package BarCode

このパッケージは、 .NET Core 6、7、8、10、およびそれ以降のバージョン、ならびに.NET Framework 4.6.2以降と互換性があります。 このライブラリはすべての依存関係を自動的に処理するため、追加のバーコードフォントやシステム設定は不要です。 インストールが完了したら、名前空間参照をコントローラーまたはサービスファイルに追加します。

using IronBarCode;

using IronBarCode;

using IronBarCode;
using Microsoft.AspNetCore.Mvc;

using IronBarCode;
using Microsoft.AspNetCore.Mvc;

ASP.NET Core Webアプリケーションでバーコードを生成するにはどうすればよいですか？

MVC コントローラーでバーコードを作成するには、 IronBarcodeの BarcodeWriter クラスを使用します。 次の例は、ユーザーが提供したURLまたはテキストに基づいてCode 128バーコードを作成する、完全なコントローラーアクションを示しています。

using IronBarCode;
using Microsoft.AspNetCore.Mvc;

public class BarcodeController : Controller
{
    public IActionResult GenerateBarcode(string data)
    {
        // Generate barcode from input data
        GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(
            data,
            BarcodeWriterEncoding.Code128);
        barcode.ResizeTo(400, 120);
        barcode.AddBarcodeValueTextBelowBarcode();
        // Return as image for display in browser
        byte[] barcodeBytes = barcode.ToPngBinaryData();
        return File(barcodeBytes, "image/png");
    }
}

using IronBarCode;
using Microsoft.AspNetCore.Mvc;

public class BarcodeController : Controller
{
    public IActionResult GenerateBarcode(string data)
    {
        // Generate barcode from input data
        GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(
            data,
            BarcodeWriterEncoding.Code128);
        barcode.ResizeTo(400, 120);
        barcode.AddBarcodeValueTextBelowBarcode();
        // Return as image for display in browser
        byte[] barcodeBytes = barcode.ToPngBinaryData();
        return File(barcodeBytes, "image/png");
    }
}

barcode.SaveAsImage("wwwroot/images/generated-barcode.png");

barcode.SaveAsImage("wwwroot/images/generated-barcode.png");

public IActionResult DownloadBarcode(string data)
{
    GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(data, BarcodeWriterEncoding.Code128);
    barcode.ResizeTo(400, 120);
    byte[] pdfBytes = barcode.ToPdfBinaryData();
    return File(pdfBytes, "application/pdf", "barcode.pdf");
}

public IActionResult DownloadBarcode(string data)
{
    GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(data, BarcodeWriterEncoding.Code128);
    barcode.ResizeTo(400, 120);
    byte[] pdfBytes = barcode.ToPdfBinaryData();
    return File(pdfBytes, "application/pdf", "barcode.pdf");
}

Webアプリケーションでサポートされているバーコードの種類は何ですか?

IronBarcodeは30種類以上のフォーマットに対応しています。 以下は、最も一般的に使用されるタイプの作成方法の詳細です：

// Create QR Code with custom size
GeneratedBarcode qrCode = QRCodeWriter.CreateQrCode(
    "https://example.com/product/12345",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Medium);
qrCode.SaveAsPng("product-qr.png");

// Create QR Code with custom size
GeneratedBarcode qrCode = QRCodeWriter.CreateQrCode(
    "https://example.com/product/12345",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Medium);
qrCode.SaveAsPng("product-qr.png");

// Create Data Matrix barcode
GeneratedBarcode dataMatrix = BarcodeWriter.CreateBarcode(
    "DMX-2024-001",
    BarcodeWriterEncoding.DataMatrix);
dataMatrix.SaveAsGif("datamatrix.gif");

// Create Data Matrix barcode
GeneratedBarcode dataMatrix = BarcodeWriter.CreateBarcode(
    "DMX-2024-001",
    BarcodeWriterEncoding.DataMatrix);
dataMatrix.SaveAsGif("datamatrix.gif");

// Create UPC-A barcode for retail products
GeneratedBarcode upcBarcode = BarcodeWriter.CreateBarcode(
    "012345678905",
    BarcodeWriterEncoding.UPCA);
upcBarcode.SaveAsPng("upc-barcode.png");

// Create UPC-A barcode for retail products
GeneratedBarcode upcBarcode = BarcodeWriter.CreateBarcode(
    "012345678905",
    BarcodeWriterEncoding.UPCA);
upcBarcode.SaveAsPng("upc-barcode.png");

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

ウェブアプリケーション用のバーコードのスタイル設定には、色、フォント、余白、注釈の調整が含まれます。 流暢なAPIにより、カスタマイズも簡単です：

GeneratedBarcode styledBarcode = BarcodeWriter.CreateBarcode(
    "STYLED-2024",
    BarcodeWriterEncoding.Code128);
// Apply styling
styledBarcode.ResizeTo(450, 150);
styledBarcode.SetMargins(20);
styledBarcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.DarkBlue);
styledBarcode.AddAnnotationTextAboveBarcode("Product ID:");
styledBarcode.AddBarcodeValueTextBelowBarcode();
// Export to multiple formats
styledBarcode.SaveAsPng("styled-barcode.png");
styledBarcode.SaveAsPdf("styled-barcode.pdf");

GeneratedBarcode styledBarcode = BarcodeWriter.CreateBarcode(
    "STYLED-2024",
    BarcodeWriterEncoding.Code128);
// Apply styling
styledBarcode.ResizeTo(450, 150);
styledBarcode.SetMargins(20);
styledBarcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.DarkBlue);
styledBarcode.AddAnnotationTextAboveBarcode("Product ID:");
styledBarcode.AddBarcodeValueTextBelowBarcode();
// Export to multiple formats
styledBarcode.SaveAsPng("styled-barcode.png");
styledBarcode.SaveAsPdf("styled-barcode.pdf");

public IActionResult DisplayBarcode()
{
    GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(
        "INV-2024-0042",
        BarcodeWriterEncoding.Code128);
    string base64Image = barcode.ToDataUrl();
    ViewBag.BarcodeImage = base64Image;
    return View();
}

public IActionResult DisplayBarcode()
{
    GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(
        "INV-2024-0042",
        BarcodeWriterEncoding.Code128);
    string base64Image = barcode.ToDataUrl();
    ViewBag.BarcodeImage = base64Image;
    return View();
}

<div class="barcode-container">
    <img src="@ViewBag.BarcodeImage" alt="Generated Barcode" />
</div>
<div class="print-actions">
    <button onclick="window.print()">Print Barcode</button>
</div>

<div class="barcode-container">
    <img src="@ViewBag.BarcodeImage" alt="Generated Barcode" />
</div>
<div class="print-actions">
    <button onclick="window.print()">Print Barcode</button>
</div>

ASP.NET Coreでバーコードを読み取り、スキャンするにはどうすればよいですか？

アップロードされた画像やファイルストリームからバーコードを読み取る処理は、BarcodeReader クラスによって行われます。 これは、受信ワークフロー、返品処理、およびスキャンされたバーコードをサーバー側でデコードする必要があるあらゆるシナリオで役立ちます。

using IronBarCode;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;

public class BarcodeScanController : Controller
{
    public IActionResult ScanBarcode(IFormFile uploadedImage)
    {
        using var stream = uploadedImage.OpenReadStream();
        var results = BarcodeReader.Read(stream);
        if (results.Count > 0)
        {
            string decodedValue = results[0].Value;
            return Ok(new { barcode = decodedValue });
        }
        return BadRequest("No barcode detected in image.");
    }
}

using IronBarCode;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;

public class BarcodeScanController : Controller
{
    public IActionResult ScanBarcode(IFormFile uploadedImage)
    {
        using var stream = uploadedImage.OpenReadStream();
        var results = BarcodeReader.Read(stream);
        if (results.Count > 0)
        {
            string decodedValue = results[0].Value;
            return Ok(new { barcode = decodedValue });
        }
        return BadRequest("No barcode detected in image.");
    }
}

BarcodeReader.Read() メソッドは、ファイル パス、ストリーム、および System.Drawing.Bitmap オブジェクトを受け入れます。 バーコード形式を自動的に検出し、デコードされた値、形式タイプ、および画像内の位置を含む BarcodeResult オブジェクトのコレクションを返します。 1枚の画像に複数のバーコードが写っている場合(例えば、倉庫の棚の写真など)、リーダーはコレクション内の検出されたすべての値を返します。最初の値だけではありません。

高スループットのASP.NETアプリケーションにおいては、パフォーマンスも考慮すべき重要な要素です。 このリーダーは、関心領域のスキャンに対応しており、分析前に画像を特定のピクセル矩形に切り抜きます。 バーコードが常に画像内の既知の領域に表示される場合、処理時間を大幅に短縮できます。

低品質画像のコントラスト調整や検出感度の調整といった高度なシナリオについては、バーコード読み取りに関するドキュメントを参照してください。

ASP.NETでバーコードをPDFにエクスポートするにはどうすればよいですか？

PDF文書に直接埋め込まれたバーコードを生成することは、出荷ラベル、倉庫タグ、およびコンプライアンス文書において一般的な要件です。 IronBarcodeはPDF形式での直接保存をサポートしています。

GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(
    "SHIP-2024-99471",
    BarcodeWriterEncoding.Code128);
barcode.ResizeTo(500, 150);
barcode.AddAnnotationTextAboveBarcode("Shipping Label");
barcode.AddBarcodeValueTextBelowBarcode();
barcode.SaveAsPdf("shipping-label.pdf");

GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(
    "SHIP-2024-99471",
    BarcodeWriterEncoding.Code128);
barcode.ResizeTo(500, 150);
barcode.AddAnnotationTextAboveBarcode("Shipping Label");
barcode.AddBarcodeValueTextBelowBarcode();
barcode.SaveAsPdf("shipping-label.pdf");

複数のバーコードを含むPDF文書(例えば、製品ラベルのページなど)の場合は、各バーコードを個別に生成し、PDFライブラリを使用してそれらを結合します。 IronPDFの統合ガイドでは、既存のPDFテンプレートにバーコードを挿入する方法が説明されており、これは事前にデザインされたラベルレイアウトにバーコードを追加する際に役立ちます。

SaveAsPdf() メソッドは出力寸法も受け付けるため、レンダリングされた PDF ページはラベル プリンターが必要とする物理的なラベル サイズと一致します。

バーコード生成エラーと検証はどのように処理していますか？

バーコードのエンコード規則はフォーマットによって異なります。 例えば、UPC-Aは正確に11桁または12桁を必要とし、EAN-13は正確に12桁または13桁を必要とし、Code 128は標準サイズで読み取り可能な出力において48文字という実用的な制限がある。 無効なデータを渡すと、IronBarCodeEncoderException が発生します。

コントローラーアクションでエンコードエラーを明示的に処理する：

public IActionResult SafeGenerate(string data, string format)
{
    try
    {
        var encoding = Enum.Parse<BarcodeWriterEncoding>(format, true);
        GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(data, encoding);
        return File(barcode.ToPngBinaryData(), "image/png");
    }
    catch (IronBarCodeEncoderException ex)
    {
        return BadRequest($"Encoding error: {ex.Message}");
    }
    catch (ArgumentException ex)
    {
        return BadRequest($"Unknown format: {ex.Message}");
    }
}

public IActionResult SafeGenerate(string data, string format)
{
    try
    {
        var encoding = Enum.Parse<BarcodeWriterEncoding>(format, true);
        GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(data, encoding);
        return File(barcode.ToPngBinaryData(), "image/png");
    }
    catch (IronBarCodeEncoderException ex)
    {
        return BadRequest($"Encoding error: {ex.Message}");
    }
    catch (ArgumentException ex)
    {
        return BadRequest($"Unknown format: {ex.Message}");
    }
}

本番環境で使用する場合は、CreateBarcode() を呼び出す前に、入力データの長さと文字セットを検証してください。 IronBarcodeのドキュメントには、サポートされている各バーコードタイプごとに、フォーマット固有のエンコード制約が記載されています。

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

IronBarcodeを使用してASP.NETバーコードジェネレーターを構築することで、 .NET Core Webアプリケーションでバーコード画像を作成、スタイル設定、エクスポートするための信頼性の高いソリューションが実現します。 このライブラリは、複雑なエンコーディング標準を自動的に処理する一方で、開発者向けのAPIを通じて幅広いカスタマイズを提供します。 モバイルスキャン用のQRコード、産業用途向けのデータマトリックスバーコード、小売向けのUPCコードなど、どのようなコードを生成する場合でも、 IronBarcodeはASP.NET MVCコントローラーおよびRazorページと直接統合されます。

さらに詳しく知るには、次のリソースを参照してください。

• IronBarcode入門ガイド- インストールと初回起動手順 -画像からのバーコード読み取り-- サーバー側でスキャンされたバーコードをデコードする
• QRコードのカスタマイズ（ロゴ、色、エラー修正など） PDFへのエクスポート-- PDFドキュメントにバーコードを埋め込む -バーコードスタイルガイド- 注釈、色、余白 -完全なAPIリファレンス- すべてのクラス、メソッド、およびプロパティ -ライセンスオプション- 本番環境への展開に適したライセンスを選択してください -ライブコード例-- すべてのバーコードタイプに対応した実行可能なサンプル
• 2Dバーコード形式-- PDF417、Aztec、MaxiCodeなど
• 1次元バーコード形式-- Code 39、ITF、EAN-13など

無料評価期間中は、すべての機能を試すことができます。 本番環境への導入および商用利用については、ライセンスオプションを確認し、プロジェクトの要件に合った適切なライセンスを選択してください。 このライブラリはビットマップとベクターのエクスポートをサポートしており、各バージョンはWindows、Linux、Android、iOSといった様々な展開環境との互換性を維持しています。

ご質問、 .NET用の代替バーコードライブラリとのベンチマーク、またはEnterprise統合サポートについては、 IronBarcodeサポートポータルをご覧ください。