Comment générer des codes QR en C# avec un package NuGet

Comment installer un package NuGet pour code QR ?

L'installation d'IronQR via le Package Manager NuGet ne prend que quelques secondes. Ouvrez la console du gestionnaire de packages NuGet dans Visual Studio et exécutez la commande suivante, ou utilisez la commande dotnet add package pour les environnements CLI :

Install-Package IronQR

Le package NuGet gère automatiquement toutes les dépendances, garantissant ainsi la compatibilité avec vos frameworks cibles. IronQR prend en charge .NET Framework 4.6.2+, .NET Core 2.0+ et .NET 5-10, ce qui en fait une bibliothèque polyvalente pour tout projet Visual Studio.

Avant d'écrire le moindre code, vous avez besoin d'une clé de licence d'essai gratuite . Configurez-le dès le début du démarrage de votre application afin que tous les appels suivants soient authentifiés :

using IronQr;

// Set license key before any IronQR operation
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

using IronQr;

// Set license key before any IronQR operation
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

Une fois la clé de licence en place, votre application est prête à générer, lire et personnaliser des codes QR sans filigrane sur les images de sortie.

Comment générer votre premier code QR ?

La création de votre premier code QR nécessite un minimum de code. La classe QrWriter gère la génération de codes QR avec des valeurs par défaut judicieuses qui conviennent à la plupart des cas d'utilisation :

using IronQr;
using IronSoftware.Drawing;

// Generate a QR code from text data
QrCode myQr = QrWriter.Write("Hello World");

// Save QR code as bitmap image
AnyBitmap qrImage = myQr.Save();

// Export to PNG file
qrImage.SaveAs("hello-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Generate a QR code from text data
QrCode myQr = QrWriter.Write("Hello World");

// Save QR code as bitmap image
AnyBitmap qrImage = myQr.Save();

// Export to PNG file
qrImage.SaveAs("hello-qr.png");

Comment choisir le bon niveau de correction d'erreur ?

Les codes QR prennent en charge quatre niveaux de correction d'erreur définis dans la norme ISO/IEC 18004 relative aux codes QR , qui déterminent le niveau de dommages qu'un code peut subir tout en restant scannable. IronQR prend en charge les quatre niveaux via la classe QrOptions :

using IronQr;
using IronSoftware.Drawing;

// Configure high error correction level
var options = new QrOptions(QrErrorCorrectionNiveau.High);

// Generate QR code with options
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap image = qr.Save();
image.SaveAs("high-correction-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Configure high error correction level
var options = new QrOptions(QrErrorCorrectionNiveau.High);

// Generate QR code with options
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap image = qr.Save();
image.SaveAs("high-correction-qr.png");

Comment personnaliser l'apparence d'un code QR ?

IronQR offre de nombreuses options de style via QrStyleOptions, permettant des couleurs personnalisées, des dimensions, des marges et l'intégration de logos. Les codes QR de marque sont plus performants dans un contexte marketing car ils associent visuellement le code à une identité connue :

using IronQr;
using IronSoftware.Drawing;

// Create styled QR code with custom colors
var styleOptions = new QrStyleOptions
{
    Dimensions = 300,    // Width and height in pixels
    Margins = 10,        // Quiet zone in pixels
    Color = Color.DarkBlue,
    BackgroundColor = Color.White
};

QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap styledImage = qr.Save(styleOptions);
styledImage.SaveAs("styled-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Create styled QR code with custom colors
var styleOptions = new QrStyleOptions
{
    Dimensions = 300,    // Width and height in pixels
    Margins = 10,        // Quiet zone in pixels
    Color = Color.DarkBlue,
    BackgroundColor = Color.White
};

QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap styledImage = qr.Save(styleOptions);
styledImage.SaveAs("styled-qr.png");

Comment enregistrer les codes QR dans différents formats de sortie ?

IronQR prend en charge plusieurs formats de sortie, notamment PNG, JPEG, GIF, TIFF, BMP et SVG. La méthode SaveAs détecte automatiquement le format à partir de l'extension du fichier :

using IronQr;
using IronSoftware.Drawing;

QrCode qr = QrWriter.Write("Format demonstration");
AnyBitmap image = qr.Save();

// Save to raster image formats
image.SaveAs("qr-output.png");
image.SaveAs("qr-output.jpg");
image.SaveAs("qr-output.gif");

// Get as byte array for HTTP responses or database storage
byte[] pngBytes = image.ExportBytes();

using IronQr;
using IronSoftware.Drawing;

QrCode qr = QrWriter.Write("Format demonstration");
AnyBitmap image = qr.Save();

// Save to raster image formats
image.SaveAs("qr-output.png");
image.SaveAs("qr-output.jpg");
image.SaveAs("qr-output.gif");

// Get as byte array for HTTP responses or database storage
byte[] pngBytes = image.ExportBytes();

Comment comparer le package NuGet IronQR avec QrCoder ?

La bibliothèque QrCoder est une option open source populaire pour la génération de codes QR en .NET. Les développeurs qui ont utilisé QrCoder connaissent bien son API en plusieurs étapes impliquant QRCodeGenerator, QRCodeData et une classe de rendu séparée telle que PngByteQRCode. IronQR simplifie cela en un seul appel QrWriter.Write().

QrCoder fonctionne bien pour la génération basique sous Windows. Le modèle d'apprentissage automatique d'IronQR offre une lecture supérieure des codes QR quel que soit l'angle, ce qui est essentiel pour les applications traitant des images soumises par l'utilisateur et dont la qualité d'entrée ne peut être contrôlée. L'API à méthode unique réduit également le nombre de lignes de code nécessaires pour déployer une fonctionnalité opérationnelle.

Pour les équipes migrant depuis QrCoder, consultez le guide de migration de QrCoder vers IronQR pour un mappage API côte à côte.

Comment encoder des données binaires dans un code QR ?

Au-delà du texte, IronQR prend en charge l'encodage de tableaux d'octets pour les charges utiles de codes QR binaires. Ceci est utile pour les jetons chiffrés, les objets sérialisés ou les identifiants binaires bruts qui ne peuvent pas être représentés sous forme de chaînes UTF-8 :

using IronQr;
using IronSoftware.Drawing;

// Encode binary data -- useful for encrypted payloads or binary identifiers
byte[] binaryData = System.Text.Encoding.UTF8.GetBytes("Binary content example");
QrCode qr = QrWriter.Write(binaryData);
qr.Save().SaveAs("binary-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Encode binary data -- useful for encrypted payloads or binary identifiers
byte[] binaryData = System.Text.Encoding.UTF8.GetBytes("Binary content example");
QrCode qr = QrWriter.Write(binaryData);
qr.Save().SaveAs("binary-qr.png");

Comment lire les codes QR en C# ?

IronQR gère à la fois l'écriture et la lecture. La classe QrReader accepte les fichiers image, les bitmaps et les images de caméra, ce qui la rend adaptée aussi bien au traitement par lots qu'aux scénarios de numérisation en temps réel :

using IronQr;
using IronSoftware.Drawing;

// Load an existing image containing a QR code
var inputImage = AnyBitmap.FromFile("qr-to-read.png");

// Read all QR codes in the image
QrReadResult readResult = QrReader.Read(inputImage);

foreach (QrResult result in readResult.QrCodes)
{
    // Access the decoded value
    Console.WriteLine($"Decoded: {result.Value}");
}

using IronQr;
using IronSoftware.Drawing;

// Load an existing image containing a QR code
var inputImage = AnyBitmap.FromFile("qr-to-read.png");

// Read all QR codes in the image
QrReadResult readResult = QrReader.Read(inputImage);

foreach (QrResult result in readResult.QrCodes)
{
    // Access the decoded value
    Console.WriteLine($"Decoded: {result.Value}");
}

Le moteur de lecture basé sur l'apprentissage automatique traite les images quelle que soit leur orientation et gère les dommages partiels jusqu'au seuil de correction d'erreur. Pour les scénarios de lecture en production, consultez le tutoriel sur la lecture des codes QR pour obtenir des conseils sur la gestion des entrées de faible qualité, des images à codes multiples et la configuration du mode de numérisation.

Comment utiliser IronQR dans une application ASP.NET Core ?

Les applications web ont fréquemment besoin de générer des codes QR à la demande — pour les liens vers les comptes utilisateurs, les codes de connexion à usage unique ou les demandes de paiement. L'exemple suivant montre comment diffuser une image de code QR directement depuis un point de terminaison d'API minimale ASP.NET Core :

using IronQr;
using IronSoftware.Drawing;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// Set license key at application startup
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

// Return a QR code PNG for a given URL parameter
app.MapGet("/qr", (string data) =>
{
    QrCode qr = QrWriter.Write(data);
    AnyBitmap image = qr.Save();
    byte[] pngBytes = image.ExportBytes();
    return Results.File(pngBytes, "image/png");
});

app.Run();

using IronQr;
using IronSoftware.Drawing;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// Set license key at application startup
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

// Return a QR code PNG for a given URL parameter
app.MapGet("/qr", (string data) =>
{
    QrCode qr = QrWriter.Write(data);
    AnyBitmap image = qr.Save();
    byte[] pngBytes = image.ExportBytes();
    return Results.File(pngBytes, "image/png");
});

app.Run();

Ce modèle fonctionne aussi bien avec les API minimales ASP.NET Core qu'avec les contrôleurs MVC standard. L'appel ExportBytes() évite l'écriture de fichiers temporaires sur le disque, ce qui est important dans les déploiements conteneurisés où le système de fichiers peut être en lecture seule ou éphémère.

Pour une présentation complète de l'intégration ASP.NET Core , consultez le tutoriel sur le générateur de code QR ASP.NET Core . Un guide spécifique à Blazor est également disponible dans le tutoriel du générateur de code QR Blazor .

Comment ajouter une marge et redimensionner une image de code QR ?

La maîtrise des dimensions et des zones de silence est essentielle pour obtenir une impression de qualité. IronQR expose les deux via QrStyleOptions, et des guides pratiques dédiés couvrent chacun en détail :

using IronQr;
using IronSoftware.Drawing;

// Specify dimensions and quiet zone for print output
var printOptions = new QrStyleOptions
{
    Dimensions = 600,   // High resolution for print
    Margins = 20        // Generous quiet zone for reliable scanning
};

QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap printImage = qr.Save(printOptions);
printImage.SaveAs("print-ready-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Specify dimensions and quiet zone for print output
var printOptions = new QrStyleOptions
{
    Dimensions = 600,   // High resolution for print
    Margins = 20        // Generous quiet zone for reliable scanning
};

QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap printImage = qr.Save(printOptions);
printImage.SaveAs("print-ready-qr.png");

Pour obtenir des instructions complètes sur les exigences de dimensionnement et de marge sur différents supports de sortie, consultez les articles pratiques sur le redimensionnement des images de codes QR et l'ajout de marges aux codes QR . Le guide de création d'images de code QR couvre l'intégralité du processus de création d'images, de l'activation de la licence à la sortie du fichier.

Pour chaque cas d'utilisation spécifique des codes QR ( génération de codes QR pour cartes de visite , création d'un générateur de codes QR dynamiques et lecture de codes QR à partir d'images ), des articles dédiés couvrent chaque scénario avec des exemples de code complets.

Quelles sont vos prochaines étapes ?

IronQR transforme la génération de codes QR, un processus en plusieurs étapes, en une intégration NuGet simple. Vous installez le package, appelez QrWriter.Write(), et enregistrez le résultat — trois opérations qui couvrent la majorité des scénarios du monde réel. Les niveaux de correction d'erreurs, le style personnalisé, l'horodatage PDF et la lecture assistée par l'apprentissage automatique sont tous disponibles via la même bibliothèque.

La documentation IronQR fournit la référence API complète, y compris des sujets avancés tels que la lecture des codes QR avec les modes de numérisation , le traitement par lots et les notes de déploiement spécifiques à la plateforme. La section tutoriels IronQR comprend des guides étape par étape pour les applications .NET MAUI, VB .NET et console.

Démarrez un essai gratuit pour explorer l'ensemble des fonctionnalités sans restrictions, ou achetez une licence pour un déploiement en production avec un support technique 24h/24 et 5j/7.