C#で誤り訂正を設定する方法 | IronQR

C#でエラー訂正を設定する方法

This article was translated from English: Does it need improvement?
Translated
View the article in English

C#バーコードのエラー訂正は、IronBarcodeのQrErrorCorrectionLevelパラメーターを使用して設定され、4つのレベル (L, M, Q, H) をサポートし、損傷したデータの7-30%を回復し、高いレベルではより複雑なQRコードを生成します。

バーコード内のError Correctionは、視覚的欠陥やエンコードエラーにもかかわらず、バーコードの読み取り可能性を維持する能力を指します。 これらの損傷は、印刷の不完全さや汚れ、傷、スキャン条件の違いなどにより発生する可能性があります。 エラー訂正は、特にC#のQRコードで作業する場合、どのタイプのBarCodeエンコーディングが適しているかを決定する大きな要因です。

一般的に、2Dバーコードは1Dバーコードに比べて以下の要因により欠損に対してより高い耐性を持っています。

  • データ容量: 2Dバーコードは、1Dバーコードよりも多くのデータを保存し、水平方向と垂直方向の両方をエンコードします。 サポートされている BarCode フォーマットについては、こちらをご覧ください。
  • 冗長性: 2Dバーコードは、データエンコードの複数の層を持ち、バーコードの一部が損傷しても残りの無傷のセクションから情報を抽出できます。
  • コンパクトさ: 2Dバーコードはそのコンパクトな形状から限られたスペースに適しています。
  • 柔軟性: 2Dバーコードはさまざまな角度と方向からスキャンできます。

不完全な BarCode や、スキャン条件が理想的でない画像修正シナリオを扱う場合、エラー修正が特に重要になります。

クイックスタート:QRコード作成でのエラー訂正レベルの使用

この短い例では、エラー訂正レベルを"中"に設定し、IronBarcodeでQRコードを生成する方法を示します。 開発者は、コンテンツ、サイズ、エラー訂正レベルを持つCreateQrCodeメソッドを使用できます。

  1. IronBarcode をNuGetパッケージマネージャでインストール

    PM > Install-Package BarCode
  2. このコード スニペットをコピーして実行します。

    var qr = IronBarCode.QRCodeWriter.CreateQrCode("https://ironsoftware.com", 500, IronBarCode.QRCodeWriter.QrErrorCorrectionLevel.Medium).SaveAsPng("qr.png");
  3. 実際の環境でテストするためにデプロイする

    今日プロジェクトで IronBarcode を使い始めましょう無料トライアル

    arrow pointer


QRコードのエラー訂正を調整するにはどうすればよいですか?

現在、IronBarcodeは包括的なバーコード生成機能の一部として、QRコードマイクロQRrMQRのエラー訂正設定をサポートしています。 QRコードの標準で指定されている4つのプリセットエラー訂正レベルをすべてサポートしています。 エラー訂正レベルはQrErrorCorrectionLevelパラメーターで調整されます。 エラー訂正の4つのレベルは以下の通りです。

  • 最上: レベルH。 データの最大30%まで回復可能です。
  • : レベルQ。 データの最大25%まで回復可能です。
  • : レベルM。 データの最大15%まで回復可能です。
  • : レベルL。 データの最大7%まで回復可能です。

より高いエラー訂正レベルは、より複雑なQRコード画像をもたらし、QRコード生成時に視覚的な明瞭さとエラー訂正のバランスを取る必要があります。 以下のコードサンプルはエラー訂正の設定を示しています。

:path=/static-assets/barcode/content-code-examples/how-to/set-error-correction.cs
// Import the necessary namespace for barcode generation
using IronBarCode;

// Create a QR code with the specified URL, size, and error correction level
GeneratedBarcode mediumCorrection = QRCodeWriter.CreateQrCode(
    "https://ironsoftware.com/csharp/barcode/", // URL to be encoded in the QR code
    500,                                       // Size of the QR code (500x500 pixels)
    QRCodeWriter.QrErrorCorrectionLevel.Medium // Error correction level to handle distortions
);

// Save the generated QR code image as a PNG file with the specified filename
mediumCorrection.SaveAsPng("mediumCorrection.png");
' Import the necessary namespace for barcode generation
Imports IronBarCode

' Create a QR code with the specified URL, size, and error correction level
Private mediumCorrection As GeneratedBarcode = QRCodeWriter.CreateQrCode("https://ironsoftware.com/csharp/barcode/", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium)

' Save the generated QR code image as a PNG file with the specified filename
mediumCorrection.SaveAsPng("mediumCorrection.png")
$vbLabelText   $csharpLabel

どの誤り訂正レベルを選択すべきですか?

エラー訂正レベルの選択は、特定の使用ケースや環境によって異なります。 QRコードが物理的な損傷、汚れ、または部分的な遮断にさらされる可能性があるアプリケーションでは、高いエラー訂正レベル (Q または H) が推奨されます。 これらのレベルは、QRコードの複雑さとサイズを増加させる代償として、より優れた耐障害性を提供します。

デジタルディスプレイや高品質の印刷のような清潔で制御された環境では、低いエラー訂正レベル (L または M) で済むことがあります。これにより、より単純で低密度のQRコードが生成され、小さいサイズでもスキャンが容易になります。 次の要素を考慮してください:

  • 物理的環境:屋外や産業環境では、より高いエラー訂正の恩恵を受ける
  • 印刷品質:低品質の印刷には、より高いエラー修正が必要です。
  • サイズの制約:スペースが限られているため、読みやすさのためにエラー修正を少なくする必要がある場合があります。
  • スキャン距離:スキャン距離が長いほど、シンプルなQRコードに適しています。

比較のために、異なるエラー訂正レベルのQRコードを生成する方法を示す例を示します:

:path=/static-assets/barcode/content-code-examples/how-to/error-correction-3.cs
using IronBarCode;
using System.Drawing;

// Generate QR codes with all four error correction levels
var content = "https://ironsoftware.com/csharp/barcode/";
int size = 500;

// Create QR codes with different error correction levels
var lowCorrection = QRCodeWriter.CreateQrCode(content, size, QRCodeWriter.QrErrorCorrectionLevel.Low);
var mediumCorrection = QRCodeWriter.CreateQrCode(content, size, QRCodeWriter.QrErrorCorrectionLevel.Medium);
var highCorrection = QRCodeWriter.CreateQrCode(content, size, QRCodeWriter.QrErrorCorrectionLevel.High);
var highestCorrection = QRCodeWriter.CreateQrCode(content, size, QRCodeWriter.QrErrorCorrectionLevel.Highest);

// Save each with descriptive filenames
lowCorrection.SaveAsPng("qr_low_correction.png");
mediumCorrection.SaveAsPng("qr_medium_correction.png");
highCorrection.SaveAsPng("qr_high_correction.png");
highestCorrection.SaveAsPng("qr_highest_correction.png");
Imports IronBarCode
Imports System.Drawing

' Generate QR codes with all four error correction levels
Dim content As String = "https://ironsoftware.com/csharp/barcode/"
Dim size As Integer = 500

' Create QR codes with different error correction levels
Dim lowCorrection = QRCodeWriter.CreateQrCode(content, size, QRCodeWriter.QrErrorCorrectionLevel.Low)
Dim mediumCorrection = QRCodeWriter.CreateQrCode(content, size, QRCodeWriter.QrErrorCorrectionLevel.Medium)
Dim highCorrection = QRCodeWriter.CreateQrCode(content, size, QRCodeWriter.QrErrorCorrectionLevel.High)
Dim highestCorrection = QRCodeWriter.CreateQrCode(content, size, QRCodeWriter.QrErrorCorrectionLevel.Highest)

' Save each with descriptive filenames
lowCorrection.SaveAsPng("qr_low_correction.png")
mediumCorrection.SaveAsPng("qr_medium_correction.png")
highCorrection.SaveAsPng("qr_high_correction.png")
highestCorrection.SaveAsPng("qr_highest_correction.png")
$vbLabelText   $csharpLabel

エラー訂正を制御するパラメータは何ですか?

IronBarcodeのエラー訂正を制御する主なパラメーターはQrErrorCorrectionLevel列挙です。 このパラメーターはCreateQrCodeメソッドに渡され、QRコードにどれだけの冗長データを埋め込むかを決定します。 カスタムQRコードを作成する場合、エラー訂正設定を他のスタイリング オプションと組み合わせることができます:

:path=/static-assets/barcode/content-code-examples/how-to/error-correction-4.cs
using IronBarCode;

// Create a styled QR code with high error correction
var styledQr = QRCodeWriter.CreateQrCode("Important Data", 500, QRCodeWriter.QrErrorCorrectionLevel.High);

// Apply custom styling
styledQr.ChangeBarCodeColor(System.Drawing.Color.DarkBlue)
    .SetMargins(10)
    .AddAnnotationTextAboveBarcode("Scan for Details");

// Export with various options
styledQr.SaveAsPng("styled_high_correction.png");
styledQr.SaveAsJpeg("styled_high_correction.jpg");
styledQr.SaveAsPdf("styled_high_correction.pdf");
Imports IronBarCode
Imports System.Drawing

' Create a styled QR code with high error correction
Dim styledQr = QRCodeWriter.CreateQrCode("Important Data", 500, QRCodeWriter.QrErrorCorrectionLevel.High)

' Apply custom styling
styledQr.ChangeBarCodeColor(Color.DarkBlue) _
    .SetMargins(10) _
    .AddAnnotationTextAboveBarcode("Scan for Details")

' Export with various options
styledQr.SaveAsPng("styled_high_correction.png")
styledQr.SaveAsJpeg("styled_high_correction.jpg")
styledQr.SaveAsPdf("styled_high_correction.pdf")
$vbLabelText   $csharpLabel

エラー訂正がQRコードの複雑さに影響するのはなぜですか

誤り訂正は、リード・ソロモン誤り訂正アルゴリズムを使ってQRコードに冗長データを追加することで機能します。 この冗長性により、QRコードリーダーはデータの欠落部分や破損部分を再構築することができます。 エラー訂正を追加すればするほど、同じ情報をエンコードするために必要なモジュール(黒と白の正方形)の数が増え、より緻密で複雑なパターンになります。

この複雑さは、BarCodeの読み取り設定やスキャンの性能に実用的な影響を与えます。 エラー修正レベルが高い場合、最適なパフォーマンスを得るためにリーダーの設定を調整する必要があります。

エラー訂正レベルの違いは何ですか?

以下は同じ値を表すがエラー訂正レベルが異なるQRコード画像のサンプルセットです。 観察されたように、より高いエラー訂正レベルは、より複雑なQRコード画像をもたらし、より高い耐障害性を提供します。

黒と白の四角形の密なパターンを示す、最高エラー訂正レベルの QR コード
密なデータパターンと堅牢なファインダーパターンを備えた、高エラー訂正レベルを示す QR コード
明瞭なデータパターンとファインダー四角形を示す、中エラー訂正レベルの QR コード
標準的な白黒のマトリックスパターンを示す、低エラー訂正レベルの QR コード

どのような場合に高次エラー訂正を使用する必要がありますか?

いくつかのシナリオでは、より高いエラー訂正レベルを推奨します:

  1. 産業用途: QRコードが過酷な条件にさらされる製品や設備で使用される場合
  2. 屋外サイネージ: 天候による損傷を受ける可能性のある屋外に表示されるQRコード
  3. 長期保管: 数年間スキャン可能である必要のある文書や製品
  4. マーケティング素材: QRコードを一部隠すロゴやデザインを組み込む場合

複数の BarCode を読み取ったり、破損した画像を処理したりする高度なシナリオでは、より高度なエラー補正がさらなる信頼性を提供します。

エラー訂正はQRコードのサイズにどのように影響しますか?

エラー訂正は、QRコードの物理的なサイズとデータ容量に直接影響します。 エラー訂正のレベルが高くなると、同じ量のデータをエンコードするために、より多くのモジュールが必要になります:

  • 同じデータコンテンツに対して大きなQRコード
  • 特定のQRコードサイズでの最大データ容量の縮小
  • スキャンが難しい可能性のある複雑なパターン
  • 生成とスキャンの両方で処理時間が増加

補正レベルの視覚的な違いは何ですか?

同じデータをエンコードしたQRコードを比較すると、エラー訂正レベルによる視覚的な違いが明らかになります。 修正レベルが低いほど、モジュール数が少ないシンプルなパターンが作成され、レベルが高いほど、より緻密で複雑なパターンが作成されます。 これらの違いは、外観だけでなく、印刷や表示に関する実用的な考慮事項にも影響します。

より高度なバーコード生成技術については、包括的なドキュメントを参照し、.NET アプリケーションで最適な結果を得るためのエラー訂正と他のバーコード機能の統合について学んでください。

よくある質問

バーコード技術におけるエラー訂正とは何ですか?

BarCodeのエラー訂正とは、視覚的な欠陥やエンコーディングエラーにもかかわらず、バーコードの可読性を維持する機能を指します。IronBarcodeはQrErrorCorrectionLevelパラメータを通してエラー訂正を実装しており、選択したレベルに応じて破損したデータの7-30%を回復することができます。

C#でQRコードを作成する際、エラー訂正レベルはどのように設定するのですか?

IronBarcodeのQRCodeWriter.CreateQrCodeメソッドでは、QrErrorCorrectionLevelパラメータを指定してエラー訂正レベルを設定できます。このメソッドには、コンテンツ、サイズ、および4つのエラー訂正レベル(L、M、Q、H)のいずれかを指定します。

QRコードで利用可能な4つのエラー訂正レベルは何ですか?

IronBarcodeはQRコードに4つのエラー訂正レベルを事前に設定することができます:L (Low - 7% recovery)、M (Medium - 15% recovery)、Q (Quartile - 25% recovery)、H (High - 30% recovery)です。より高いレベルは、より複雑なQRコードを作成しますが、より優れた耐ダメージを提供します。

どのバーコードタイプがエラー訂正設定をサポートしていますか?

現在、IronBarcodeはQRコード、マイクロQR、rMQRのエラー訂正レベルの設定をサポートしています。これらの2次元バーコードフォーマットは、従来の1次元バーコードに比べて優れたエラー訂正機能を提供します。

なぜ 2D バーコードは 1D バーコードよりもエラー修正が優れているのですか?

IronBarcodeがサポートする2Dバーコードは、より高いデータ容量(水平方向と垂直方向の両方をエンコード)、無傷の部分からデータを抽出できる内蔵の冗長性、限られたスペースに適したコンパクトな形状、さまざまな角度からスキャンできる柔軟性により、より優れたエラー訂正機能を備えています。

どのような場合に高いエラー訂正レベルを使用する必要がありますか?

不完全な印刷条件、潜在的な物理的損傷(傷、汚れ)、困難なスキャン環境、または長期的な耐久性が必要な場合は、IronBarcodeで高いエラー訂正レベルを使用してください。レベルが高いほど信頼性の高いスキャンが可能になりますが、QRコードの複雑さが増します。

IronBarcodeはバーコードの外観カスタマイズをサポートしていますか?

はい、IronBarcodeはカラー、サイズ、テキスト注釈を含むバーコードの外観に関する詳細なカスタマイズオプションを提供し、特定のデザイン要件に合わせて調整が可能です。

IronBarcodeはビジネスプロセスの効率向上にどのように役立ちますか?

IronBarcodeは迅速かつ正確なバーコード生成と読み取りを可能にし、手動データ入力エラーの減少、在庫および資産追跡の改善などにより、ビジネスプロセスの効率を向上させます。

プロジェクトにIronBarcodeを実装するために必要なプログラミングスキルは何ですか?

IronBarcodeをプロジェクトに実装するためには、C#プログラミングの基本的な知識があれば十分で、開発者をガイドするための簡単なメソッドと包括的なドキュメントが提供されています。

IronBarcodeは小規模プロジェクトと大規模エンタープライズアプリケーションの両方に適していますか?

IronBarcodeはスケーラブルかつ多用途に設計されており、小規模プロジェクトおよび強力なバーコードソリューションを必要とする大規模エンタープライズアプリケーションの両方に適しています。

Hairil Hasyimi Bin Omar
ソフトウェアエンジニア
すべての優れたエンジニアのように、ハイリルは熱心な学習者です。彼はC#、Python、Javaの知識を磨き、その知識を活用してIron Softwareのチームメンバーに価値を追加しています。ハイリルはマレーシアのマラ工科大学からIron Softwareのチームに参加し、化学およびプロセス工学の学士号を取得しました。
準備はできましたか?
Nuget ダウンロード 2,331,688 | バージョン: 2026.7 リリースされたばかり
Still Scrolling Icon

まだスクロールしていますか?

すぐに証拠が欲しいですか? PM > Install-Package BarCode
サンプルを実行する 文字列が BarCode になるのを見る。