Comment Définir les Niveaux de Correction d'Erreurs lors de Générer un Code QR

Mis à jour:8 mars 2026

Translated

View the article in English

Prenez le contrôle des performances. Ajustez les paramètres de correction d'erreurs pour créer des codes QR plus rapides et plus durables qui peuvent résister aux dommages et être toujours scannés de manière fiable.

La correction d'erreurs est ce qui sépare un code QR qui se désintègre d'un autre qui continue de fonctionner. Lorsque l'étiquette imprimée est rayée, un autocollant se décolle ou une affiche se décolore au soleil, la correction d'erreurs détermine si le code est encore scannable. IronQR permet aux développeurs de choisir exactement la résilience d'un code QR, des codes légers optimisés pour les écrans numériques nets aux codes robustes conçus pour survivre dans les entrepôts et les ateliers.

Ce guide démontre comment configurer des niveaux de correction d'erreurs en utilisant la bibliothèque IronQR, en équilibrant la densité de données contre la tolérance aux dommages pour tout cas d'utilisation. Les développeurs novices dans la génération de codes QR devraient commencer par le guide Créer un code QR en tant qu'image.

Démarrage rapide : Configurer la correction d'erreurs du code QR

Configurez le niveau de correction d'erreurs via QrOptions et générez un code QR résilient.

Installez IronQR avec le Gestionnaire de Packages NuGet
PM > Install-Package IronQR

Copiez et exécutez cet extrait de code.

var options = new QrOptions(QrErrorCorrectionLevel.Medium);
var qrCode = QrWriter.Write("https://example.com", options);
qrCode.Save().SaveAs("qr-medium.png");

Déployez pour tester sur votre environnement de production.

Commencez à utiliser IronQR dans votre projet dès aujourd'hui avec un essai gratuit

Flux de travail minimal (5 étapes)

Téléchargez la bibliothèque IronQR C# pour générer des codes QR avec correction d'erreurs
Créez un objet `QrOptions` avec un `ErrorCorrectionLevel` choisi
Générez le code QR en utilisant `QrWriter.Write()` avec ces options
Enregistrez le code QR en tant que bitmap avec `Save()`
Exportez le bitmap vers un fichier image avec `SaveAs()`

Comprendre les niveaux de correction d'erreurs

Les codes QR utilisent la correction d'erreurs de Reed-Solomon pour rester scannables même lorsqu'ils sont partiellement endommagés ou masqués. L'énumération QrErrorCorrectionLevel dans IronQR offre quatre niveaux, chacun échangeant la capacité de données contre une résilience accrue :

Niveau	Capacité de récupération	Meilleur pour
`QrErrorCorrectionLevel.Low`	~7% de dommages	Écrans numériques, environnements contrôlés
`QrErrorCorrectionLevel.Medium`	~15% de dommages	Utilisation polyvalente, durabilité modérée
`QrErrorCorrectionLevel.High`	~25% de dommages	Matériaux imprimés, signalisation extérieure
`QrErrorCorrectionLevel.Highest`	~30% de dommages	Étiquettes industrielles, conditions difficiles

Une correction d'erreurs plus élevée ajoute plus de modules redondants, ce qui augmente la densité visuelle du code QR. Cela affecte également la taille de l'image générée, les développeurs peuvent donc avoir besoin d'ajuster les dimensions en conséquence. Le niveau le plus bas qui répond aux exigences de durabilité garde le code compact et rapide à scanner.

Configurer le niveau de correction d'erreur

Pour définir le niveau de correction d'erreurs, passez la valeur QrErrorCorrectionLevel souhaitée au constructeur QrOptions. Ensuite, passez ces options à QrWriter.Write() lors de la génération du code QR.

Dans cet exemple, la correction d'erreurs est réglée sur Medium, ce qui récupère jusqu'à 15% des données endommagées tout en gardant le code compact.

:path=/static-assets/qr/content-code-examples/how-to/error-correction-qr-code.cs

using IronQr;
using IronSoftware.Drawing;

QrOptions options = new QrOptions(QrErrorCorrectionLevel.Medium);

// Create QR code
QrCode qr = QrWriter.Write("1234", options);

// Save QR code as a bitmap
AnyBitmap qrImage = qr.Save();

// Save QR code bitmap as file
qrImage.SaveAs("qrMedium.png");

Imports IronQr
Imports IronSoftware.Drawing

Dim options As New QrOptions(QrErrorCorrectionLevel.Medium)

' Create QR code
Dim qr As QrCode = QrWriter.Write("1234", options)

' Save QR code as a bitmap
Dim qrImage As AnyBitmap = qr.Save()

' Save QR code bitmap as file
qrImage.SaveAs("qrMedium.png")

$vbLabelText $csharpLabel

Sortie

Comparer les niveaux de correction d'erreurs

Chaque niveau produit un code QR visuellement différent. Les niveaux inférieurs génèrent des motifs plus simples qui se scannent plus rapidement, tandis que les niveaux supérieurs créent des motifs plus denses qui survivent davantage aux dommages. Voici comment générer les mêmes données à chaque niveau pour comparaison :

:path=/static-assets/qr/content-code-examples/how-to/error-correction-qr-code-compare.cs

using IronQr;
using IronSoftware.Drawing;

string data = "https://ironsoftware.com";

// Low - ~7% recovery, smallest code
QrCode qrLow = QrWriter.Write(data, new QrOptions(QrErrorCorrectionLevel.Low));
qrLow.Save().SaveAs("qrLow.png");

// Medium - ~15% recovery, balanced
QrCode qrMedium = QrWriter.Write(data, new QrOptions(QrErrorCorrectionLevel.Medium));
qrMedium.Save().SaveAs("qrMedium.png");

// High - ~25% recovery, durable
QrCode qrHigh = QrWriter.Write(data, new QrOptions(QrErrorCorrectionLevel.High));
qrHigh.Save().SaveAs("qrHigh.png");

// Highest - ~30% recovery, maximum resilience
QrCode qrHighest = QrWriter.Write(data, new QrOptions(QrErrorCorrectionLevel.Highest));
qrHighest.Save().SaveAs("qrHighest.png");

Imports IronQr
Imports IronSoftware.Drawing

Dim data As String = "https://ironsoftware.com"

' Low - ~7% recovery, smallest code
Dim qrLow As QrCode = QrWriter.Write(data, New QrOptions(QrErrorCorrectionLevel.Low))
qrLow.Save().SaveAs("qrLow.png")

' Medium - ~15% recovery, balanced
Dim qrMedium As QrCode = QrWriter.Write(data, New QrOptions(QrErrorCorrectionLevel.Medium))
qrMedium.Save().SaveAs("qrMedium.png")

' High - ~25% recovery, durable
Dim qrHigh As QrCode = QrWriter.Write(data, New QrOptions(QrErrorCorrectionLevel.High))
qrHigh.Save().SaveAs("qrHigh.png")

' Highest - ~30% recovery, maximum resilience
Dim qrHighest As QrCode = QrWriter.Write(data, New QrOptions(QrErrorCorrectionLevel.Highest))
qrHighest.Save().SaveAs("qrHighest.png")

$vbLabelText $csharpLabel

Veuillez noterLes niveaux de correction d'erreurs plus élevés augmentent le nombre de modules dans le code QR, ce qui rend le motif plus dense. Si la vitesse de scan est prioritaire, il est recommandé de choisir le niveau le plus bas qui répond aux besoins de durabilité du projet.

Sortie

Faible (~7% de récupération)

Moyen (~15% de récupération)

Élevé (~25% de récupération)

Très élevé (~30% de récupération)

Choisir le bon niveau pour le cas d'utilisation

Le bon niveau de correction d'erreurs dépend de l'endroit où le code QR sera utilisé et de ce qu'il doit supporter :

Cas d'utilisation	Niveau	Pourquoi	Guide lié
Affichages numériques et sites web	`QrErrorCorrectionLevel.Low`	L'écran est propre, l'éclairage est contrôlé, pas d'usure physique. Garde le code simple et rapide à scanner.	Créer un code QR en tant qu'image
Cartes de visite, dépliants et signalisation intérieure	`QrErrorCorrectionLevel.Medium`	La manipulation légère et les légers plis n'affecteront pas le scan. Associez avec des marges appropriées pour de meilleurs résultats.	Ajouter des marges au code QR
Emballages de produits et affiches extérieures	`QrErrorCorrectionLevel.High`	Les matériaux sont exposés à la pluie, aux UV et à une manipulation brutale lors de l'expédition. Augmentez la taille pour le scan à distance.	Redimensionner le code QR
Étiquettes d'entrepôt, sols d'usine et étiquettes industrielles	`QrErrorCorrectionLevel.Highest`	Environnements difficiles où les codes sont rayés, tachés ou partiellement couverts. La redondance maximale les maintient opérationnels.	Lire les codes QR à partir d'une image

Pour des modèles de génération de codes QR plus avancés, explorez le tutoriel C# QR Code Generator et l'ensemble complet des fonctionnalités IronQR.

Curtis Chau

Discutez maintenant avec l'équipe d'ingénierie

Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Prêt à commencer?

Nuget Téléchargements 63,625 | Version : 2026.4 vient de sortir