Codes QR .NET Core: Lire et générer des codes QR en C#

Comment installer la bibliothèque de codes QR ?

L'installation IronQR via NuGet ne prend que quelques secondes. Ouvrez Visual Studio, accédez à Outils > Gestionnaire de packages NuGet > Gérer les packages NuGet pour la solution , recherchez IronQR, et cliquez sur Installer . Ce package possède un minimum de dépendances et est compatible nativement avec Windows, macOS et Linux.

Install-Package IronQR

IronQR cible .NET Core 6, 7, 8, 9 et 10, ainsi que .NET Framework 4.6.2 et versions ultérieures. Pour les projets multiplateformes, une intégration SkiaSharp gère le traitement d'images sur les environnements d'exécution non-Windows. La bibliothèque fonctionne avec les applications web ASP.NET Core , les applications console et les solutions de bureau sans configuration d'exécution supplémentaire. Une fois installées, toutes les méthodes et tous les types d'extensions nécessaires sont immédiatement disponibles.

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

La lecture des données des codes QR à partir de fichiers image ne nécessite que quelques lignes de code. La classe QrReader utilise un modèle d'apprentissage automatique avancé qui évalue la qualité de l'image et sélectionne automatiquement le mode de segmentation approprié, vous donnant des résultats précis même lorsque l'image d'entrée n'est pas idéale.

using IronQr;
using IronSoftware.Drawing;

// Load image containing QR code
var inputBmp = AnyBitmap.FromFile("qr-sample.png");
// Create QrImageInput from the bitmap
QrImageInput imageInput = new QrImageInput(inputBmp);
// Initialize QR Reader with ML model
QrReader reader = new QrReader();
// Read and decode all QR codes in the image
IEnumerable<QrResult> results = reader.Read(imageInput);
// Output decoded text strings
foreach (var qrCode in results)
{
    Console.WriteLine($"QR Code Value: {qrCode.Value}");
    Console.WriteLine($"URL: {qrCode.Url}");
}

using IronQr;
using IronSoftware.Drawing;

// Load image containing QR code
var inputBmp = AnyBitmap.FromFile("qr-sample.png");
// Create QrImageInput from the bitmap
QrImageInput imageInput = new QrImageInput(inputBmp);
// Initialize QR Reader with ML model
QrReader reader = new QrReader();
// Read and decode all QR codes in the image
IEnumerable<QrResult> results = reader.Read(imageInput);
// Output decoded text strings
foreach (var qrCode in results)
{
    Console.WriteLine($"QR Code Value: {qrCode.Value}");
    Console.WriteLine($"URL: {qrCode.Url}");
}

Comment extraire des données avancées de codes QR ?

Au-delà du décodage de valeurs de base, IronQR expose les coordonnées, les segments de données brutes et les informations au niveau du module de chaque symbole scanné. Ceci est essentiel pour les flux de travail de traitement de documents où il est nécessaire de savoir précisément où un code QR apparaît sur la page, ou pour les applications qui doivent gérer plusieurs codes dans une seule image.

using IronQr;
using IronSoftware.Drawing;

var inputBmp = AnyBitmap.FromFile("document-with-qr.png");
QrImageInput imageInput = new QrImageInput(inputBmp);
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);
foreach (var qrCode in results)
{
    // Access decoded value
    Console.WriteLine($"Data: {qrCode.Value}");
    // Get corner coordinate positions
    foreach (PointF point in qrCode.Points)
    {
        Console.WriteLine($"Position: {point.X}, {point.Y}");
    }
}

using IronQr;
using IronSoftware.Drawing;

var inputBmp = AnyBitmap.FromFile("document-with-qr.png");
QrImageInput imageInput = new QrImageInput(inputBmp);
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);
foreach (var qrCode in results)
{
    // Access decoded value
    Console.WriteLine($"Data: {qrCode.Value}");
    // Get corner coordinate positions
    foreach (PointF point in qrCode.Points)
    {
        Console.WriteLine($"Position: {point.X}, {point.Y}");
    }
}

Comment les niveaux de correction d'erreurs affectent-ils la qualité des codes QR ?

La correction d'erreurs est le mécanisme qui permet à un lecteur de code QR de récupérer les données originales même lorsqu'une partie du code est masquée, mal imprimée ou physiquement endommagée. La norme QR Code définit quatre niveaux – Faible (L), Moyen (M), Quartile (Q) et Élevé (H) – chacun privilégiant la capacité de stockage à la tolérance aux dommages.

Lors de la génération de codes QR, la spécification d'un niveau de correction d'erreur plus élevé garantit que le résultat reste fiable dans des conditions de lecture réelles :

using IronQr;
using IronSoftware.Drawing;

// Configure QR options with high error correction
var qrOptions = new QrOptions(QrErrorCorrectionLevel.High, 20);
// Generate a QR code with specified error correction
QrCode myQr = QrWriter.Write("https://ironsoftware.com", qrOptions);
// Save as PNG image
AnyBitmap qrImage = myQr.Save();
qrImage.SaveAs("high-error-correction-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Configure QR options with high error correction
var qrOptions = new QrOptions(QrErrorCorrectionLevel.High, 20);
// Generate a QR code with specified error correction
QrCode myQr = QrWriter.Write("https://ironsoftware.com", qrOptions);
// Save as PNG image
AnyBitmap qrImage = myQr.Save();
qrImage.SaveAs("high-error-correction-qr.png");

Comment générer des codes QR avec des caractères internationaux ?

IronQR prend en charge toute la gamme des modes d'encodage QR : numérique, alphanumérique, octet et Kanji. Pour les textes japonais et autres contenus Unicode, la bibliothèque sélectionne automatiquement l'encodage le plus économe en espace :

using IronQr;
using IronSoftware.Drawing;

// Generate QR that encodes Japanese Unicode text
QrCode japaneseQr = QrWriter.Write("こんにちは世界");
// The library selects Kanji mode automatically
AnyBitmap qrImage = japaneseQr.Save();
qrImage.SaveAs("japanese-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Generate QR that encodes Japanese Unicode text
QrCode japaneseQr = QrWriter.Write("こんにちは世界");
// The library selects Kanji mode automatically
AnyBitmap qrImage = japaneseQr.Save();
qrImage.SaveAs("japanese-qr.png");

Comment utiliser les générateurs de charge utile pour les données QR structurées ?

Un code QR qui encode une simple URL fonctionne pour le partage de liens simples, mais de nombreuses applications ont besoin d'encoder des données structurées : identifiants WiFi, fiches de contact au format vCard ou données d'événements. Le formatage manuel de ces charges utiles est source d'erreurs ; L'absence d'un point-virgule ou un ordre incorrect des champs peuvent entraîner une mauvaise interprétation des données par les scanners.

IronQR fournit des fonctions d'assistance pour la charge utile qui construisent correctement ces chaînes structurées :

using IronQr;
using IronSoftware.Drawing;

// Generate QR code with URL payload
var urlQrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
// Save QR as PNG image file
AnyBitmap qrImage = urlQrCode.Save();
qrImage.SaveAs("url-qr-code.png");
Console.WriteLine("QR code generated successfully.");

using IronQr;
using IronSoftware.Drawing;

// Generate QR code with URL payload
var urlQrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
// Save QR as PNG image file
AnyBitmap qrImage = urlQrCode.Save();
qrImage.SaveAs("url-qr-code.png");
Console.WriteLine("QR code generated successfully.");

Comment personnaliser l'apparence d'un code QR ?

IronQR vous permet de contrôler l'apparence visuelle des codes générés sans sacrifier leur lisibilité. Vous pouvez modifier les couleurs de premier plan et d'arrière-plan, appliquer une identité visuelle personnalisée ou intégrer un logo dans la zone de silence centrale.

using IronQr;
using IronSoftware.Drawing;

// Define custom colors for the QR code
var darkColor = Color.FromArgb(30, 30, 120);   // Deep navy foreground
var lightColor = Color.White;

var options = new QrOptions(QrErrorCorrectionLevel.High, maxVersion: 20)
{
    BackgroundColor = lightColor,
    Color = darkColor,
    // Embed a logo image into the QR center
    Logo = AnyBitmap.FromFile("logo.png")
};

QrCode styledQr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap output = styledQr.Save();
output.SaveAs("branded-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Define custom colors for the QR code
var darkColor = Color.FromArgb(30, 30, 120);   // Deep navy foreground
var lightColor = Color.White;

var options = new QrOptions(QrErrorCorrectionLevel.High, maxVersion: 20)
{
    BackgroundColor = lightColor,
    Color = darkColor,
    // Embed a logo image into the QR center
    Logo = AnyBitmap.FromFile("logo.png")
};

QrCode styledQr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap output = styledQr.Save();
output.SaveAs("branded-qr.png");

L'intégration d'un logo réduit la zone de données effective, la bibliothèque exige donc un niveau de correction d'erreurs H lorsqu'un logo est fourni. La zone de silence réservée au centre représente environ 30 % de la surface du code, ce qui est dans la capacité de récupération du niveau H. La bibliothèque applique automatiquement cette contrainte : si vous définissez un niveau de correction d'erreur inférieur en plus d'un logo, IronQR génère une exception avec un message descriptif au lieu de produire un code dont l'analyse est peu fiable.

Pour les applications ASP.NET Core , le tutoriel sur le générateur de codes QR ASP.NET Core montre comment servir les codes QR générés en tant que réponses d'image à partir d'une action de contrôleur. Le flux de sortie écrit directement dans la réponse sans E/S de fichiers intermédiaires, ce qui maintient une faible latence pour les points de terminaison à fort trafic.

Comment lire les codes QR dans une application ASP.NET Core ?

La numérisation des codes QR côté serveur (à partir d'images téléchargées, de chaînes de traitement de documents ou de systèmes d'inspection automatisés) est un cas d'utilisation courant de l'API de lecture. Le guide du scanner de code QR ASP.NET couvre la configuration complète du contrôleur et du service, mais le modèle de lecture de base est le même que celui d'une application console :

using IronQr;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/qr")]
public class QrScanController : ControllerBase
{
    [HttpPost("scan")]
    public IActionResult Scan(IFormFile imageFile)
    {
        using var stream = imageFile.OpenReadStream();
        var bitmap = AnyBitmap.FromStream(stream);
        var imageInput = new QrImageInput(bitmap);
        var reader = new QrReader();
        var results = reader.Read(imageInput);

        var decoded = results.Select(r => new { r.Value, r.Url }).ToList();
        return Ok(decoded);
    }
}

using IronQr;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/qr")]
public class QrScanController : ControllerBase
{
    [HttpPost("scan")]
    public IActionResult Scan(IFormFile imageFile)
    {
        using var stream = imageFile.OpenReadStream();
        var bitmap = AnyBitmap.FromStream(stream);
        var imageInput = new QrImageInput(bitmap);
        var reader = new QrReader();
        var results = reader.Read(imageInput);

        var decoded = results.Select(r => new { r.Value, r.Url }).ToList();
        return Ok(decoded);
    }
}

La méthode AnyBitmap.FromStream() accepte tout flux lisible ; le même chemin d'exécution fonctionne donc pour les fichiers téléchargés via un formulaire, les images récupérées depuis un stockage blob ou les images extraites d'un pipeline vidéo. Le contrôleur n'écrit aucun fichier temporaire sur le disque, ce qui est important pour les déploiements conteneurisés où le système de fichiers peut être en lecture seule.

Pour les scénarios à haut débit, instanciez QrReader une fois par durée de vie de l'application en tant que singleton, puisque le coût de chargement du modèle ML est payé lors de la première construction. Les appels suivants Read() sur la même instance sont thread-safe et partagent le modèle chargé.

Comment générer des codes QR dans une application .NET MAUI ?

Le tutoriel sur les codes QR .NET MAUI démontre la génération multiplateforme complète sur iOS, Android, macOS et Windows. IronQR utilise le moteur de rendu SkiaSharp lorsqu'il est exécuté sur des plateformes non-Windows, ce qui garantit un rendu cohérent sur toutes les cibles MAUI.

using IronQr;
using IronSoftware.Drawing;

// Generate QR and convert to a byte array for display in MAUI
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap bitmap = qr.Save();
byte[] imageBytes = bitmap.ExportBytes();

// Bind imageBytes to an <Image Source> in your MAUI page

using IronQr;
using IronSoftware.Drawing;

// Generate QR and convert to a byte array for display in MAUI
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap bitmap = qr.Save();
byte[] imageBytes = bitmap.ExportBytes();

// Bind imageBytes to an <Image Source> in your MAUI page

Sur les cibles mobiles, ExportBytes() renvoie un tableau d'octets PNG que vous pouvez alimenter directement dans un StreamImageSource ou écrire dans un ImageButton. L'échafaudage MAUI ne nécessite aucun chemin de code spécifique à la plateforme : la même logique de génération s'exécute de manière identique sur les quatre cibles MAUI.

Pour les projets VB .NET , la surface de l'API est identique ; Seule la syntaxe diffère. La bibliothèque est fournie sous forme d'un seul package NuGet , sans qu'aucun assembly VB .NET séparé ne soit requis.

Quelles sont vos prochaines étapes ?

IronQR couvre l'intégralité du cycle de vie des codes QR en .NET , de la génération de base et de l'encodage structuré de la charge utile à la lecture par apprentissage automatique des codes endommagés ou marqués. La bibliothèque gère l'encodage Kanji, la configuration de la correction d'erreurs et la sortie d'images multiplateformes, vous permettant ainsi de vous concentrer sur la logique spécifique à votre application.

Pour mettre en pratique ce que vous avez appris :

• Consultez le tutoriel sur le lecteur de codes QR en C# pour une analyse plus approfondie de l'API de lecture et du traitement des résultats.
• Suivez le tutoriel de l'application de génération de code QR C# pour obtenir une présentation complète du projet.
• Consultez les exemples de code pour découvrir d'autres modèles de génération et de lecture.
• Achetez une licence IronQR pour débloquer toutes les fonctionnalités pour un déploiement en production, ou prolongez la période d'essai gratuite si vous avez besoin de plus de temps d'évaluation.