1. IronQR
  2. Guides pratiques
  3. Correction d'erreur de QR Code

Comment définir les niveaux de correction d'erreurs des codes QR

Curtis Chau
Curtis Chau
Mis à jour:
This article was translated from English: Does it need improvement?
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 QR résilient.

  1. Installez IronQR avec le Gestionnaire de Packages NuGet

    PM > Install-Package IronQR

  2. 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");

  3. Déployez pour tester sur votre environnement de production.

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

    arrow pointer

Flux de travail minimal (5 étapes)

  1. Téléchargez la bibliothèque IronQR C# pour générer des codes QR avec correction d'erreurs
  2. Créez un objet QrOptions avec un ErrorCorrectionLevel choisi
  3. Générez le code QR en utilisant QrWriter.Write() avec ces options
  4. Enregistrez le code QR en tant que bitmap avec Save()
  5. 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 propose quatre niveaux, chacun offrant un compromis entre capacité de données et 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 des erreurs, transmettez la valeur QrErrorCorrectionLevel souhaitée au constructeur QrOptions. Transmettez ensuite ces options à QrWriter.Write() lors de la génération du 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

Code QR avec correction d'erreurs Medium

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

QR Code with Low Error Correction

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

Code QR avec correction d'erreurs Medium

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

QR Code with High Error Correction

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

QR Code with Highest Error Correction

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.

Questions Fréquemment Posées

Quels sont les niveaux de correction d'erreur de code QR disponibles dans IronQR ?

IronQR offre quatre niveaux de correction d'erreur pour les codes QR : Bas, Moyen, Quartile et Élevé. Ces niveaux aident à maintenir la lisibilité des codes QR même lorsqu'ils sont partiellement endommagés.

Comment puis-je définir le niveau de correction d'erreur pour un code QR en utilisant IronQR en C# ?

Vous pouvez définir le niveau de correction d'erreur dans IronQR en configurant la propriété QrErrorCorrectionLevel dans la classe QrOptions. Utilisez la méthode QrWriter.Write pour générer le code QR avec le niveau de correction d'erreur spécifié.

Pourquoi la correction d'erreur est-elle importante pour les codes QR ?

La correction d'erreur est cruciale pour les codes QR car elle garantit qu'ils restent lisibles même s'ils sont partiellement endommagés ou obscurcis. IronQR vous permet de sélectionner différents niveaux de correction d'erreur pour répondre à vos besoins.

IronQR peut-il gérer la génération de codes QR avec des paramètres de correction d'erreur personnalisés ?

Oui, IronQR vous permet de personnaliser les paramètres de correction d'erreur pour vos codes QR, vous permettant de trouver un équilibre entre la capacité des données et la robustesse contre les dommages.

Quel est le niveau de correction d'erreur par défaut dans IronQR ?

IronQR par défaut utilise généralement un niveau de correction d'erreur moyen, qui offre une approche équilibrée entre la capacité des données et la résistance aux erreurs, mais vous pouvez le personnaliser selon vos besoins.

Est-il possible de changer le niveau de correction d'erreur d'un code QR existant en utilisant IronQR ?

Pour changer le niveau de correction d'erreur, vous devez régénérer le code QR avec le niveau de correction d'erreur souhaité en utilisant les classes QrOptions et QrWriter d'IronQR.

Comment un niveau de correction d'erreur plus élevé affecte-t-il la taille du code QR ?

Augmenter le niveau de correction d'erreur entraîne généralement des codes QR plus grands car plus de données redondantes sont incluses pour améliorer la récupération après des dommages, ce qui est géré efficacement par IronQR.

Quels scénarios pourraient nécessiter un niveau de correction d'erreur élevé dans les codes QR ?

Des niveaux de correction d'erreur élevés sont bénéfiques dans des environnements où les codes QR sont susceptibles de subir des dommages, tels que les environnements industriels ou extérieurs, garantissant que les données restent accessibles. IronQR offre de la flexibilité en vous permettant de définir ce niveau.

Est-il nécessaire de posséder des compétences avancées en programmation pour définir des niveaux de correction d'erreur avec IronQR ?

Non, IronQR est conçu pour être convivial, permettant même aux débutants de facilement définir les niveaux de correction d'erreur des codes QR en utilisant du code C# simple.

IronQR peut-il être utilisé pour générer des codes QR pour des applications commerciales nécessitant des corrections d'erreur spécifiques ?

Oui, IronQR est idéal pour les applications commerciales car il fournit des niveaux de correction d'erreur personnalisables, garantissant que les codes QR peuvent résister à diverses conditions tout en maintenant l'intégrité des données.

Curtis Chau
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 ...

Lire la suite
Prêt à commencer?
Nuget Téléchargements 67,270 | Version : 2026.5 just released
Still Scrolling Icon

Vous faites encore défiler ?

Vous voulez une preuve rapidement ? PM > Install-Package IronQR
exécuter un échantillon regarder votre URL devenir un code QR.