IRONQRの使用

ASP .NET CoreでQRコードを生成する方法

Curtis Chau
Curtis Chau
Updated: 2026年4月21日

QRコードは現代技術の重要な一部となっており、情報を便利に保存および送信する方法を提供しています。 Web開発では、私たちがASP.NET Coreで実装するIronQRのようなQRコードジェネレーターは、動的なQRコード作成のための強力な機能を提供します。 QRコードジェネレーターは、チケッティングシステム、認証、在庫管理など、さまざまなアプリケーションにとって不可欠です。 この記事では、IronQRを使用してASP.NET CoreでQRコードを作成するプロセスについて詳しく説明します。これはこの目的のために設計された強力なライブラリです。 ASP.NET Coreは、Webアプリケーションを構築するための多用途なフレームワークであり、QRコード生成のための強力な機能を提供します。 この記事では、Iron Softwareから提供されるQRコード生成の強力なライブラリであるIronQRを使用してASP.NET CoreでQRコードを作成するプロセスについて詳しく説明します。

ASP.NET CoreでQRコードを生成する方法

  1. Visual Studioを使用してASP.Netプロジェクトを作成
  2. パッケージマネージャーからIronQRライブラリをインストール
  3. QRコードを生成
  4. フォーマット付きでQRコードを生成

IronQRの理解

IronQRは、.NETアプリケーション向けの高性能なQRコード生成ライブラリです。 さまざまなカスタマイズオプションでQRコードを生成するためのシンプルで直感的なAPIを提供します。 IronQRは.NET Standardをサポートしており、ASP.NET Coreを含む幅広いプラットフォームと互換性があります。 IronQRを使用すると、開発者はさまざまなデータ型、エラー訂正レベル、サイズ、および形式でQRコードを手軽に生成できます。

主な特徴

1. QRコードの読取りと作成

IronQRは、QRコードの生成と読み取りを簡単に行うことができます。 動的にQRコードを作成する必要がある場合でも、既存のものから情報を抽出する必要がある場合でも、このライブラリが役立ちます。

2. 使いやすいAPI

このライブラリは使いやすいAPIを提供し、開発者が.NETプロジェクトにバーコード機能を迅速に統合できるようにします。 数分でQRコードの作業を開始できます。

3. 互換性

IronQRは、以下を含む様々な.NETバージョンをサポートしています：

  1. C#、VB.NET、F#
  2. .NET Core（8、7、6、5、および3.1以上）
  3. .NET Standard（2.0以上）
  4. .NET Framework（4.6.2以上）

Web (Blazor & WebForms)、モバイル (Xamarin & MAUI)、デスクトップ (WPF & MAUI)、コンソールアプリケーションなど、幅広いプロジェクトタイプをカバーします。

4. QR検出のための機械学習モデル

IronQRはQRコードを検出するために高度なカスタム機械学習モデルを使用します。 これにより正確で信頼性のあるコード認識が保証されます。 また、軽量なアプローチを好む人のために、スリムモードオプション（機械学習なし）も利用可能です。

5. QRコードの読み取り

様々な画像形式からQRコードを読むことができます：

  1. 画像（jpg、png、svg、bmp）
  2. マルチページ画像（gif、tif、tiff）
  3. System.Drawing ビットマップ
  4. IronDrawing イメージ (AnyBitmap)

6. QRコードの書き込み

IronQRを使用すると、以下のような異なるドキュメントタイプでQRコードを書き込むことができます：

  1. 画像（jpg、png、gif、tiff、bmp）
  2. System.Drawing イメージ
  3. ストリーム (MemoryStream, byte[])
  4. PDF（既存PDFへのスタンプとして）

7. QRコードのスタイリング

サイズを変更し、余白や境界を調整し、色を変更し、ロゴを追加することでQRコードをカスタマイズします。

8. エラーハンドリングと訂正

IronQRは詳細なエラーメッセージを提供し、カスタムのQRエラー訂正レベルをサポートします。

この知識をもとに、ASP.NET CoreでQRコードを生成するアプリケーションを始めましょう。

ステップ1：Visual Studioを使用して新しいASP.NETプロジェクトを作成する

QRコード生成を始める前に、新しいASP.NET Coreプロジェクトを設定しましょう。 新しいプロジェクトを開始する手順は次のとおりです：

Visual Studioで新しいプロジェクトを作成し、ASP.Net Core Web Appアプリケーションテンプレートを選択します

ASP .NET Core でQRコードを生成する方法: 図1 - ASP.NET COREのウェブアプリケーションテンプレートを選択

"作成"ボタンをクリックしてテンプレートからアプリケーションコードを生成します

ASP .NET Core でQRコードを生成する方法: 図2 - プロジェクト名と保存先を指定

必要な.NETバージョンを選択します。

ASP .NET Core でQRコードを生成する方法: 図3 - 適切な.NETバージョンを選択

IronQRはNuGetパッケージマネージャーを使用してもインストールできます。

ASP .NET Core でQRコードを生成する方法: 図4 -

ステップ 2: パッケージマネージャーから IronQR ライブラリをインストール

Visual Studioパッケージマネージャーから以下のようにIronQRライブラリをインストールします。

ASP .NET Core でQRコードを生成する方法: 図5 - IronOCRをVisual Studioのパッケージマネージャーで検索してインストール

IronQRは、NuGetパッケージマネージャを使用してインストールすることもできます。

ASP .NET Core でQRコードを生成する方法: 図6 - NuGetパッケージマネージャーでIronOCRを検索

ステップ3：QRコードを生成する

では、QRコードアプリを作成しましょう。

QRCode モデルを作成

using System.ComponentModel.DataAnnotations;

namespace GenerateQRCode.Models
{
    public class QRCodeModel
    {
        [Display(Name = "Enter QR Code Text")]
        public string QRCodeText { get; set; }
    }
}

QRコードコントローラを作成

新しいコントローラを追加するには、コントローラフォルダを右クリックし、以下のように名前を付けます。

ASP .NET Core でQRコードを生成する方法: 図7 - フォルダをクリックして新しいコントローラーを追加し、名前を付ける

空のコントローラを選択します。

ASP .NET Core でQRコードを生成する方法: 図8 - プロンプトで空のコントローラーをクリック

名前を提供します。

ASP .NET Core でQRコードを生成する方法: 図9 - コントローラーに名前を付ける

次に、以下のコードをコントローラに統合します。

using GenerateQRCode.Models;
using IronSoftware.Drawing;
using IronQr;
using Microsoft.AspNetCore.Mvc;

namespace GenerateQRCode.Controllers
{
    public class QrCodeController : Controller
    {
        private readonly IWebHostEnvironment _environment;

        public QrCodeController(IWebHostEnvironment environment)
        {
            _environment = environment;
        }

        public IActionResult Index()
        {
            return View();
        }

        [HttpPost]
        public IActionResult CreateQRCode(QRCodeModel generateQRCode)
        {
            try
            {
                string path = Path.Combine(_environment.WebRootPath, "GeneratedQRCode");
                if (!Directory.Exists(path))
                {
                    Directory.CreateDirectory(path);
                }
                string filePath = Path.Combine(_environment.WebRootPath, "GeneratedQRCode/qrcode.png");
                // Create a QR Code object
                QrCode myQr = QrWriter.Write(generateQRCode.QRCodeText);
                // Save QR Code as a Bitmap
                AnyBitmap qrImage = myQr.Save();
                // Save QR Code Bitmap as File
                qrImage.SaveAs(filePath);
                string fileName = Path.GetFileName(filePath); // qr code file
                string imageUrl = $"{this.Request.Scheme}://{this.Request.Host}{this.Request.PathBase}" + "/GeneratedQRCode/" + fileName;
                ViewBag.QrCodeUri = imageUrl;
            }
            catch (Exception)
            {
                throw;
            }
            return View();
        }
    }
}

コードの説明

名前空間とクラス定義

コードはusingステートメントから始まり、必要な名前空間をインポートします。 GenerateQRCode.Controllers 名前空間にはQrCodeController クラスが含まれています。

コントローラコンストラクタ

QrCodeController クラスにはIWebHostEnvironment パラメーターを受け取るコンストラクターがあります。 このパラメータは、ASP.NET CoreによってWebホスティング関連のタスクを処理するために注入されます。

アクションメソッド

  • Index(): このメソッドはアクセス時にビュー（おそらくHTMLページ）を返します。 QRコード生成とは直接関係がないようです。
  • CreateQRCode(QRCodeModel generateQRCode): このメソッドはQRコード生成のロジックの要です。 それはパラメーターとしてQRCodeModel オブジェクトを受け取ります（おそらくQRコードテキストを含んでいます）。

メソッド内

  • 生成されたQRコード画像を保存するためのパスを構築します。
  • QrWriter.Write(generateQRCode.QRCodeText) を使用してQRコードオブジェクトを作成。
  • QRコードをビットマップ画像として保存します。
  • Webリクエストの詳細に基づいて画像URLを構築します。
  • 画像URLでViewBag.QrCodeUri プロパティを設定。
  • このプロセス中に例外が発生した場合、それらはスローされます。

QRコード生成

実際のQRコード生成はCreateQRCode メソッド内で行われます。 QrWriter.Write(generateQRCode.QRCodeText) 呼び出しにより、提供されたテキストに基づいてQRコードオブジェクトが作成されます。

画像の保存

生成されたQRコードはqrImage.SaveAs(filePath) を使用してビットマップ画像として保存されます。 次に、以下のコードをビューに置き換えます。

画像URL

imageUrl はWebリクエストのスキーム、ホスト、およびパスベースを使用して構築されます。 このURLは、生成されたQRコード画像にアクセスできる場所を指します。 全体として、このコントローラーはQRコードの生成、画像の保存、さらなる使用のための画像URLの提供を処理します。

コントローラーにビューを追加

新しいビューを追加するには、QrCodeController クラス内のCreateQRCode アクションメソッドを右クリックします。

ASP .NET Core でQRコードを生成する方法: 図10 - QrCodeController クラスに新しいビューを追加

"ビューの追加"を選択し、"Razorビュー"を選択します。 "追加"ボタンをクリックします。

ASP .NET Core でQRコードを生成する方法: 図11 -

チケッティング、認証、情報共有のためのQRコードは、データを効率的に送信するための多目的なソリューションを提供します。

ASP .NET Core でQRコードを生成する方法: 図12 - 以前に生成されたCreate テンプレートを選択

QRコード生成をASP.NET Coreプロジェクトに組み込み、動的データエンコーディングと共有のための可能性の世界を開放しましょう。

@model GenerateQRCode.Models.QRCodeModel

@{
    ViewData["Title"] = "Generate QR Code";
}

<h1>Generate QR Code</h1>
<h4>QRCodeModel</h4>
<hr />
<div class="row">
    <div class="col-md-4">
        <form asp-action="CreateQRCode">
            <div asp-validation-summary="ModelOnly" class="text-danger"></div>
            <div class="form-group">
                <label asp-for="QRCodeText" class="control-label"></label>
                <input asp-for="QRCodeText" class="form-control" />
                <span asp-validation-for="QRCodeText" class="text-danger"></span>
            </div>
            <div class="form-group">
                <a href="#" class="btn btn-primary">Create QR Code</a>
            </div>
            <div class="form-group">
                <img src="@ViewBag.QrCodeUri" class="img-thumbnail" alt="Your QR Code will appear here." />
            </div>
        </form>
    </div>
</div>
<div>
    <a asp-action="Index">Clear</a>
</div>
@section Scripts {
    @{await Html.RenderPartialAsync("_ValidationScriptsPartial");}
}

ASP .NET CoreでQRコードを生成する方法: 図1 - ASP.NET CORE Webアプリケーションテンプレートを選択

今、Program.cs で、上記のビューをデフォルトのルートとするように以下のコードを変更します。

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=QrCode}/{action=Index}"
);

このアクションは、デフォルトルートをHomeController からQrCodeController に変更します。

プロジェクトをコンパイルして実行します。

ASP .NET Core でQRコードを生成する方法: 図13 - プロジェクトのホームページ例

テキストボックスに任意のテキストを入力し、"作成"をクリックします。これにより、下に示す新しいQRコードが作成されます。

ASP .NET Core でQRコードを生成する方法: 図14 - 任意のテキストを入力し、IronQRを利用して新しいQRコードを生成するために作成をクリック

QRコードにスタイルを追加

QrStyleOptions はQRコード生成をスタイル設定するために使用されます。

[HttpPost]
public IActionResult CreateQRCode(QRCodeModel generateQRCode)
{
    try
    {
        string path = Path.Combine(_environment.WebRootPath, "GeneratedQRCode");
        if (!Directory.Exists(path))
        {
            Directory.CreateDirectory(path);
        }
        string filePath = Path.Combine(_environment.WebRootPath, "GeneratedQRCode/qrcode.png");

        // Create a QR Code object
        QrCode qrCode = QrWriter.Write(generateQRCode.QRCodeText);
        QrStyleOptions style = new QrStyleOptions
        {
            Dimensions = 300, // px size
            Margins = 10,     // px margins
            Color = Color.YellowGreen // custom color
        };

        // Save QR Code with style options as a bitmap
        AnyBitmap qrImage = qrCode.Save(style);
        // Save QR Code Bitmap to File
        qrImage.SaveAs(filePath);

        string fileName = Path.GetFileName(filePath); // qr code file
        string imageUrl = $"{this.Request.Scheme}://{this.Request.Host}{this.Request.PathBase}" + "/GeneratedQRCode/" + fileName;
        ViewBag.QrCodeUri = imageUrl;
    }
    catch (Exception)
    {
        throw;
    }
    return View();
}

出力

ASP .NET Core でQRコードを生成する方法: 図15 - プログラム的にQRコードの色を変更

ライセンス (トライアル利用可能)

IronQRを試してみたい開発者向けに、トライアルライセンスがこちらで利用可能です。 このライセンスキーをappSettings.json ファイルに配置する必要があります。こうすることで、上記の画像に表示される透かしを削除します。

{
  "IronQr.License.LicenseKey": "My key"
}
JSON

結論

この記事では、IronQRを使用してASP.NET CoreでQRコードを生成する方法を探ります。 IronQRの力を活用することで、開発者はQRコード生成機能を簡単にウェブアプリケーションに統合できます。 チケット発行、認証、情報共有のいずれにおいても、QRコードはデータを効率的に伝達するための多目的ソリューションを提供します。 IronQRを使用すれば、ASP.NET CoreでQRコードを作成およびカスタマイズするのがこれまでになく簡単になります。 QR コード生成を ASP.NET Core プロジェクトに組み込み、動的なデータのエンコードと共有の可能性を広げましょう。

Curtis Chau
Curtis Chau
テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

詳しく読む

関連する記事