Comment lire les valeurs des codes QR en C

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

Extrait instantanément le texte décodé de toute image de code QR. Obtenez la chaîne brute prête à être affichée, stockée ou traitée dans votre application.

Lire la valeur d'un code QR est la première étape de tout flux de travail de numérisation. Un terminal de paiement a besoin de l'ID de transaction intégré dans un code QR. Un système d'entrepôt a besoin de la référence produit sur une étiquette. Un validateur de billets a besoin du code de réservation imprimé sur un billet d'événement. IronQR simplifie cela : chargez l'image, passez-la à QrReader, et lisez la chaîne décodée directement à partir du résultat.

Ce guide démontre comment extraire les valeurs des codes QR à partir d'images en utilisant la bibliothèque IronQR. Les développeurs qui n'ont pas encore généré un code QR devraient d'abord commencer par le guide Créer un code QR en tant qu'image.

Démarrage rapide : Lire la valeur d'un code QR

Chargez une image, numérisez-la avec QrReader, et extrayez la chaîne décodée.

  1. Installez IronQR avec le Gestionnaire de Packages NuGet

    PM > Install-Package IronQR
  2. Copiez et exécutez cet extrait de code.

    var input = new QrImageInput("qr-code.png");
    var results = new QrReader().Read(input);
    Console.WriteLine(results.First().Value);
  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

Comment lire la valeur d'un code QR à partir d'une image ?

Pour extraire la valeur intégrée dans un code QR, chargez l'image dans un QrImageInput, passez-la à QrReader.Read(), et accédez à la propriété Value sur le QrResult retourné. La méthode renvoie une collection, un résultat par code QR trouvé dans l'image.

Entrée

Le code QR ci-dessous encode https://ironsoftware.com et sera scanné pour en extraire sa valeur.

Le code QR encodant https://ironsoftware.com utilisé comme entrée pour la numérisation
:path=/static-assets/qr/content-code-examples/how-to/read-qr-code-value.cs
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 and 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}");
Imports IronQr
Imports System.Drawing
Imports System.Linq

' Import image
Dim inputImage As Image = Image.FromFile("sample.jpg")

' Load the asset into QrImageInput
Dim imageInput As New QrImageInput(inputImage)

' Create a QR Reader object
Dim reader As New QrReader()

' Read the input and get all embedded QR codes
Dim results As IEnumerable(Of QrResult) = reader.Read(imageInput)

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

La propriété Value renvoie la chaîne décodée brute exactement telle qu'elle a été encodée : une URL, un nombre, un texte libre ou toute autre donnée. La méthode Read() retourne toujours un IEnumerable<QrResult>, même lorsqu'un seul code QR est présent. Si l'image contient plusieurs codes QR, itérez avec foreach (var result in results) pour traiter chacun d'eux. Gardez avec results.Any() avant d'appeler .First() pour gérer les images où aucun code QR n'est trouvé.

Sortie

Sortie de la console montrant la valeur décodée du code QR https://ironsoftware.com

Comment lire toutes les propriétés d'un code QR ?

Chaque QrResult expose trois propriétés qui ensemble donnent une vue d'ensemble de ce qui a été scanné et où il a été trouvé dans l'image. En utilisant le même code QR d'entrée que ci-dessus :

:path=/static-assets/qr/content-code-examples/how-to/read-qr-code-value-properties.cs
using IronQr;
using IronSoftware.Drawing;

AnyBitmap inputImage = AnyBitmap.FromFile("sample.jpg");

QrImageInput imageInput = new QrImageInput(inputImage);
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);

QrResult result = results.First();

// Decoded text content of the QR code
Console.WriteLine($"Value: {result.Value}");

// Parsed URL — populated when Value is a valid URL, null otherwise
Console.WriteLine($"Url:   {result.Url}");

// Corner coordinates of the QR code in the image [TL, TR, BL, BR]
string[] labels = { "Top-Left", "Top-Right", "Bottom-Left", "Bottom-Right" };
for (int i = 0; i < result.Points.Length; i++)
{
    Console.WriteLine($"{labels[i]}: ({result.Points[i].X}, {result.Points[i].Y})");
}
Imports IronQr
Imports IronSoftware.Drawing

Dim inputImage As AnyBitmap = AnyBitmap.FromFile("sample.jpg")

Dim imageInput As New QrImageInput(inputImage)
Dim reader As New QrReader()
Dim results As IEnumerable(Of QrResult) = reader.Read(imageInput)

Dim result As QrResult = results.First()

' Decoded text content of the QR code
Console.WriteLine($"Value: {result.Value}")

' Parsed URL — populated when Value is a valid URL, Nothing otherwise
Console.WriteLine($"Url:   {result.Url}")

' Corner coordinates of the QR code in the image [TL, TR, BL, BR]
Dim labels As String() = {"Top-Left", "Top-Right", "Bottom-Left", "Bottom-Right"}
For i As Integer = 0 To result.Points.Length - 1
    Console.WriteLine($"{labels(i)}: ({result.Points(i).X}, {result.Points(i).Y})")
Next i
$vbLabelText   $csharpLabel

Sortie

Sortie de la console montrant les propriétés Value, Url et Points lues à partir d'un code QR

Quelles propriétés QrResult expose-t-il ?

QrResult expose les propriétés suivantes après une numérisation réussie :

Propriété Type Description
Value string La chaîne décodée brute exactement telle qu'encodée. Peut contenir une URL, un texte brut, un ID numérique, un JSON ou toute autre donnée. C'est la propriété principale pour la plupart des applications.
Url Uri Un objet Uri analysé rempli lorsque Value est une URL absolue valide. Utilisez-le pour ouvrir des liens, valider des domaines ou extraire des composants d'URL. Retourne null si la valeur n'est pas une URL.
Points PointF[] Quatre coordonnées d'angle marquant la position du code QR dans l'image source, ordonnées [Top-Left, Top-Right, Bottom-Left, Bottom-Right]. Utilisez-le pour dessiner des boîtes de délimitation, recadrer des régions ou calculer la zone de numérisation.

Quels sont les cas d'utilisation courants pour la lecture des valeurs des codes QR ?

  • Terminaux de paiement : Décodez une URL de transaction ou un ID de référence à partir d'un code QR du client pour lancer un flux de paiement.
  • Validation des billets : Extrayez une référence de réservation à partir d'un code QR imprimé ou affiché à l'écran pour vérifier l'entrée à un événement.
  • Gestion des stocks : Lisez des numéros de série de produits ou des SKU à partir des étiquettes d'entrepôt pour mettre à jour les enregistrements de stocks.
  • Vérification de documents : Récupérez un ID d'enregistrement ou un hachage à partir d'un code QR apposé sur un document légal ou gouvernemental.
  • Authentification des utilisateurs : Décodez un jeton à usage unique à partir d'un code QR pour compléter une étape de connexion à deux facteurs.

Pour plus de modèles de lecture de code QR, explorez le guide Lire les codes QR à partir d'une image et l'ensemble complet de fonctionnalités IronQR.

Curtis Chau
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 63,625 | Version : 2026.4 vient de sortir
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.