C#で画像からQRコードを読み取る方法

Curtis Chau
Curtis Chau
更新日: 2026年8月2日

IronQRは、開発者がIronDrawingを使用してイメージを読み込み、QrImageInputオブジェクトを作成し、QrReader.Readメソッドを使用してQRデータを効率的にデコードすることで、C#で様々なイメージフォーマットからQRコードを読み取ることを可能にします。

クイックスタート:C#で画像からQRコードを読み取る

異なる画像フォーマットからQRコードを読み取るにはどうすればよいですか?

IronQRは様々な画像フォーマットからのQRコード読み取りをサポートしています。 この機能は、異なるメディアタイプ間で正確なデコードを保証するために高度な機械学習モデルを使用します。サポートされているフォーマットには以下が含まれます。

  • ジョイントフォトグラフィックエキスパーツグループ (JPEG)
  • ポータブル・ネットワーク・グラフィックス (PNG)
  • グラフィックス・インターチェンジ・フォーマット (GIF)
  • タグ付画像ファイル形式 (TIFF)
  • ビットマップ画像ファイル (BMP)
  • WBMP
  • WebP
  • アイコン(ico)
  • WMF
  • RawFormat(生データ)

このフォーマットのサポートは、画像処理を効率的に処理するオープンソースライブラリIronDrawingによって有効化されています。 デジタルカメラ、スキャナ、モバイル機器、WebダウンロードからのQRコードを、フォーマット変換なしで処理できます。

画像スキャンのテスト用に、四角形とデータモジュールの位置を示す白黒パターンが明確なサンプルQRコード
  1. 1IronQR を NuGet Package Manager でインストールします

    PM > Install-Package IronQR

  2. 2このコード スニペットをコピーして実行します。

    // Import necessary IronQR and IronDrawing namespaces
    using IronSoftware.Drawing; 
    using IronQr;
    
    public class QRCodeReader
    {
        public static void Main()
        {
            // Load an image from a file path
            using (var inputImage = Image.FromFile("path/to/your/image/file.webp"))
            {
                // Create a QrImageInput object from the image
                var qrImageInput = new QrImageInput(inputImage);
    
                // Create a QR Reader and decode the QR code from the image
                var reader = new QrReader();
                var results = reader.Read(qrImageInput);
    
                // Iterate through each detected QR code and display its information
                foreach (var qrResult in results)
                {
                    Console.WriteLine($"QR Code Data: {qrResult.Value}");
                }
            }
        }
    }
  3. 3実際の環境でテストするためにデプロイする

    今日からご自身のプロジェクトでIronQRを使い始めるには、無料トライアルをお試しください。
    arrow pointer

注: 「path/to/your/image/file.webp」を QR コード画像ファイルへの実際のパスに置き換えます。

サンプル画像の QR コードの値について知りたいですか? コード スニペットを使って試してみてください。

なぜIronQRは複数の画像形式をサポートするのですか?

QRコードの読み取りとは、QRコードに格納された情報をスキャンして解読することです。 これは通常、QR コードのデータを解釈できるソフトウェアと組み合わせたカメラまたはスキャナーを使用して行われます。 QR コードに含まれる情報には、テキスト、URL、連絡先の詳細、その他の形式のデータなどがあります。

IronQRのマルチフォーマットサポートは、マーケティング資料や製品パッケージからデジタルドキュメント、ウェブコンテンツまで、さまざまなコンテキストでQRコードを使用する実際のアプリケーションにとって不可欠です。 多様なフォーマットをサポートすることで、IronQRは画像フォーマットの互換性を心配することなく信頼性の高いアプリケーションを構築することを開発者に保証します。 IronQRの読み取り機能について詳しく学んで、この柔軟性が開発ワークフローをどのように強化するかを理解してください。

各画像フォーマットはいつ使用すべきですか?

QRコード処理では、画像形式によって目的が異なります:

  • PNG: 透明性を必要とするQRコードや画像品質が非常に重要な場合に最適。 PNGの可逆圧縮により、QRコードのパターンを鮮明で読みやすく保ちます。
  • JPEG: QRコードを含む写真やファイルサイズが懸念される場合に理想的。 圧縮アーチファクトが可読性に影響するのを防ぐため、より高い品質設定(80%以上)を使用してください。
  • TIFF: アーカイブ目的やエンタープライズ環境でスキャンされたドキュメントを扱う場合に完璧。
  • WebP: 素晴らしい圧縮と品質を維持するモダンフォーマットで、ウェブアプリケーションに理想的。

任意のフォーマットで最適な結果を得るには、印刷されたQRコードの場合、画像の解像度を300 DPI以上に保持して、コントラストを十分に確保してください。フォーマット固有の最適化技術に関しては、当社の高度なQR読み取り例を確認してください。

画像の品質が悪い場合、どうなりますか?

IronQRは不完全な画像を処理するためにフォールトトレランス機能を組み込んでいます。 画質の悪い画像を扱う場合、ライブラリはいくつかの戦略を採用しています:

  1. 誤り修正: QRコードには誤り修正機能(L、M、Q、Hレベル)が含まれており、最大30%が損傷している場合でもデータを回復できます。
  2. 機械学習の強化: IronQRのMLモデルは、ぼやけ、歪み、不十分な照明などの一般的な問題を検出し補正します。
  3. 前処理: 自動画像強調によってデコード試行の前にコントラストとシャープネスを向上させます。

困難な状況ではカスタムQR読み取りモードオプションを使用して読み取りプロセスを微調整することを検討してください。

// Example: Reading QR codes from a poor quality image
using IronQr;

public class EnhancedQRReader
{
    public static void ReadPoorQualityImage()
    {
        using (var inputImage = Image.FromFile("blurry_qr_code.jpg"))
        {
            // Create a QrImageInput and read with a QR Reader
            var qrImageInput = new QrImageInput(inputImage);
            var reader = new QrReader();
            var results = reader.Read(qrImageInput);
            
            foreach (var result in results)
            {
                Console.WriteLine($"Decoded: {result.Value}");
            }
        }
    }
}

QRコードから値を取得する

[//]:# (これはコメントであり、非表示になります。 上記の例では、「Value(価値)」について言及しました。 また、定義する際には、より説明的でありながら簡潔な役割を担います)

ほとんどのIronQR関数は複数の検出をサポートするためにコレクションを返します。 resultsはオブジェクトのシーケンスであるため、Valueプロパティ自体を持っていません。 この例コードは特にコレクションから最初のQrResultを選択し、そのValueを取得します。

using System;
using System.Collections.Generic;
using System.Linq;
using IronQr;
using System.Drawing;

// Import image
var inputImage = Image.FromFile("sample.jpg");

// Load the asset into QrImageInput
QrImageInput imageInput = new QrImageInput(inputImage);

// Create a QR Reader object
QrReader reader = new QrReader();

// Read the Input an get all embedded QR Codes
IEnumerable<QrResult> results = reader.Read(imageInput);

// Display the value of the first QR code found
Console.WriteLine($"QR code value is {results.First().Value}");

画像内のQRコードの位置を検出する

IronQRは単純なデコードにとどまらず、画像内のQRコードの位置を正確に特定します。 この配置は標準の座標系を使用しており、PointF(0,0)は画像の左上隅を表します。 QRコードの隅の正確な空間座標は、Points[]配列を通じてアクセス可能です。

この例では、検出されたQRコードの4点すべての座標が取得され、コンソールに出力されます。

注意してください: この関数によって返される座標は厳密な「ジグザグ」順序で格納されます: 左上、右上、左下、そして最後に右下
using System;
using System.Collections.Generic;
using IronQr;
using System.Drawing;
using System.Linq;

// Import an image containing a QR code
var inputImage = Image.FromFile("urlQr.png");

// Load the asset into a QrImageInput object
var imageInput = new QrImageInput(inputImage);

// Create a QR Reader object
var reader = new QrReader();

// Read the input and get all embedded QR codes
IEnumerable<QrResult> results = reader.Read(imageInput);

// [TL, TR, BL, BR]
string[] labels = { "Top-Left", "Top-Right", "Bottom-Left", "Bottom-Right" };

var points = results.First().Points;

for (int i = 0; i < points.Length; i++)
{
    Console.WriteLine($"{labels[i]}: {points[i].X}, {points[i].Y}");
}

入力QRコード

QRコード

出力

システムは、すべてのQRコードのコーナーの正確な空間座標をコンソールに記録していることに注目してください。

エッジ検出QR

サポートされているQRコードの種類

作成と読み取りの両方で、複数の種類の QR コードがサポートされています。 IronQRは多様なアプリケーションのニーズに応えるため、様々なQRコードフォーマットを包括的にサポートしています。 当社のドキュメントでサポートされているQRフォーマットについてさらに学んでください。 サポートされている QR コードの種類は次のとおりです。

  • QRCode: 今日最も一般的に使用される標準のQRコード。 最大7,089文字の数字または4,296文字の英数字を格納できるため、ウェブサイトのURLや連絡先情報などの用途に適しています。
画像スキャンのテスト用に、四角形とデータモジュールの位置を示す白黒パターンが明確なサンプルQRコード
  • MicroQRCode: 限られたスペース用に設計された標準QRコードの小型版。 最大35文字の数字または21文字の英数字を格納でき、小さなパッケージや小さな印刷ラベルに最適です。
典型的なQRコードの構造を示すファインダーパターンとデータモジュールを含む標準的なQRコード
  • RMQRCode: RMQR Code(長方形マイクロQRコード)は、四角ではなくコンパクトな長方形のバージョンです。 このバージョンは、アスペクト比を柔軟に変更できるので、長方形のスペースが利用できるアプリケーションに便利です。
長方形QRコードの例(標準的な位置マーカーとデータパターンを使用した非正方形フォーマット

適切なQRコードの種類をどのように選択するのですか?

適切なQRコードタイプの選択は、特定の使用ケースと制約によって決まります:

  • 標準QRコード: スペースが限られておらず最大データ容量が必要な場合の一般的なアプリケーション向けです。 URL、WiFi認証情報、vCard連絡先、または詳細な製品情報に最適です。 実装の詳細は、当社のQRコード生成の例を参照してください。
  • マイクロQRコード: 電子部品、ジュエリータグ、医療機器などの小さい表面で作業する場合に理想的です。 限られた容量にもかかわらず、シリアル番号、単純なURL、または基本的な追跡コードに最適です。
  • RMQRコード: 利用可能なスペースが特定の寸法に制約される場合、たとえば円筒製品の狭いラベルや包装縁の細長いスペースなどの場合に長方形のコードを選択します。

データの保存制限は何ですか?

データ容量を理解することで、QRコードの実装を最適化できます:

QRコードタイプ数値のみ英数字バイナリ漢字
標準QR7,0894,2962,9531,817
マイクロQR3521159
RMQR変数変数変数変数

データストレージを計画する際には、これらの要素を考慮してください:

  • 利用可能なスペースを最大化するために、WebリンクにURL短縮機能を使用してください。
  • 大規模データセットのデータ圧縮の実装
  • 適切なエラー訂正レベルを選択する(訂正レベルが高いほど、容量が減少します)

高度な実装のために、データ容量と美学のバランスをとるための当社のスタイルQRコード生成ガイドを探ってください。

いつマイクロまたはRMQRコードを使用すれば良いですか?

マイクロコードとRMQRコードは、特定のシナリオに優れています:

マイクロQRコードは次のような用途に最適です:。

  • 部品追跡が必要な電子回路基板
  • 患者や薬の識別子が必要な小型医療機器
  • 刻印スペースが限られているジュエリー認証
  • 製造業における小型製品ラベル

RMQRコードが最適な場合:

  • チューブやパイプに貼られる幅の狭い出荷ラベル
  • ペン軸やツールの細長いスペース
  • バナー形式のマーケティング資料
  • 既存の長方形のデザイン要素への統合

異なるQRコードタイプを読み取るための実用例です。

using IronQr;
using IronSoftware.Drawing;

public class MultiTypeQRReader
{
    public static void ReadVariousQRTypes()
    {
        string[] imagePaths = {
            "standard_qr.png",
            "micro_qr.png", 
            "rectangular_qr.png"
        };

        // Create a QR Reader that handles all QR code types
        var reader = new QrReader();

        foreach (var path in imagePaths)
        {
            using (var image = Image.FromFile(path))
            {
                var qrInput = new QrImageInput(image);
                var results = reader.Read(qrInput);
                
                foreach (var qr in results)
                {
                    Console.WriteLine($"Type: {qr.QrType}");
                    Console.WriteLine($"Data: {qr.Value}");
                    Console.WriteLine("---");
                }
            }
        }
    }
}

制作環境へのデプロイメントの場合、NuGetパッケージガイドを確認してプラットフォームに適したパッケージを確保し、利用可能なすべてのメソッドとプロパティに関する包括的なドキュメントをAPIリファレンスで確認してください。

よくある質問

IronQRを使用してさまざまな画像形式からQRコードを読み取る方法は?

IronQRはJPEG、PNG、GIFなど、さまざまな画像形式からQRコードの読み取りをサポートしています。これは、高度な機械学習モデルにより、さまざまなメディアタイプにわたって正確なデコードを保証し、効率的な画像処理のためのIronDrawingライブラリによって可能になります。

C#でIronQRを使用して画像からQRコードを読み取るには、どのような手順が必要ですか?

IronQRを使用して画像からQRコードを読み取るには、まずIronQRライブラリをダウンロードし、IronDrawingで画像データをインポートし、QrImageInputオブジェクトを作成し、QrReader.Readメソッドに渡して、検出された各QRコードを反復処理してその情報を確認する必要があります。

IronQRが複数の画像形式をサポートすることはなぜ重要ですか?

複数の画像形式をサポートすることにより、IronQRはリアルワールドのアプリケーションで柔軟に対応できます。QRコードはマーケティング素材、製品パッケージ、デジタル文書、Webコンテンツなど、さまざまなコンテキストで存在する可能性があります。これにより開発者はフォーマットの互換性問題を心配せずにアプリケーションを構築できます。

IronQRでQRコードを読み取るのに適した画像形式は何ですか?

画像形式の選択はニーズに依存します。透明性が必要なQRコードにはPNG、QRコードが含まれる写真にはJPEG、アーカイブ目的にはTIFF、優れた圧縮が必要なWebアプリケーションにはWebPを使用します。最良の結果を得るために、画像は十分な解像度とコントラストを持つようにします。

IronQRは品質の低い画像をどのように処理しますか?

IronQRは、エラー補正や機械学習モデルなどのフォールトトレランス機能を使用して、ぼやけや照明不良などの問題を補償します。画像のコントラストと鮮明さを自動的に強化し、厳しい条件でのカスタムQR読み取りモードオプションを提供します。

IronQRはどのようなタイプのQRコードを読み取ることができますか?

IronQRは、Standard QR Code、Micro QR Code、RMQR CodeなどのさまざまなタイプのQRコードを読み取ることができ、コンパクトまたは長方形の形式が必要なアプリケーションのさまざまなユースケースやデータ容量をサポートします。

MicroまたはRMQRコードを選択するのはいつですか?

回路基板や医療機器のような小さな表面にはMicro QRコードを選択し、狭い出荷ラベルやマーケティング資料のような細長いスペースに合わせる必要がある長方形ラベルにはRMQRコードを選択します。

IronQRは画像内のQRコードをどのように特定しますか?

IronQRは標準的な座標系を使用して、画像内のQRコードの位置を特定します。Points[]配列を使用して、QRコードの角の正確な空間座標を取得し、出力します。

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

もっと読む

準備はできましたか?

NuGetダウンロード数 82,442バージョン:2026.11ちょうどリリースされました