UTILISATION D'IRONBARCODE

.NET QR Code Generator (Tutoriel d'exemple de code)

Jordi Bardia
Jordi Bardia
septembre 14, 2022
Mise à jour février 7, 2024
Partager:

Ce tutoriel utilisera IronBarcode comme bibliothèque de base pour générer des codes QR qui ont de nombreuses applications dans différents secteurs d'activité.

Présentation d'IronBarcode

Caractéristiques supplémentaires

  • IronBarcode peut lire et écrire la plupart des types de codes-barres et des normes QR, tels que UPC A/E, EAN 8/13, Code 39/93/128, ITF, MSI, RSS 14/Expanded, Databar et CodaB.
  • IronBarcode traite automatiquement les images de codes-barres pour améliorer l'efficacité et la précision de la lecture.
  • IronBarcode peut lire les scans et les images vidéo en direct, corrigeant la rotation, le bruit, la distorsion et le biais.
  • IronBarcode peut être utilisé sur plusieurs cœurs et threads (très utile pour les applications serveur qui effectuent un traitement par lots).
  • IronBarcode peut trouver automatiquement un ou plusieurs codes-barres dans des documents d'une ou plusieurs pages.
  • IronBarcode prend en charge les architectures 32 bits et 64 bits et peut être utilisé dans les implémentations .NET (.NET Core et .NET Framework).
  • IronBarcode prend en charge les applications Console, Desktop, Cloud et Web sur les plateformes PC et mobiles.
  • IronBarcode peut générer des images de code QR pour une gamme de fichiers et de formats de flux, y compris PDF, JPG, TIFF, GIF, BMP, PNG et HTML.

Générer des QR Codes avec IronBarcode

Les sections suivantes de cet article présentent un exemple pour démontrer comment générer facilement des codes QR.

Étape 1. Créer un nouveau projet

Ouvrez Visual Studio, et sélectionnez Nouveau projet dans le menu Fichier.

Choisissez le modèle Application Console dans la fenêtre qui apparaît, puis cliquez sur Suivant.

Générateur de code QR .NET (Exemple de tutoriel de code), Figure 1 : Création d'une nouvelle application console dans Visual Studio pour la génération de codes QR

Créer une nouvelle application console dans Visual Studio pour la génération de codes QR

Dans le champ de texte Nom du projet, saisissez n'importe quel nom de projet de votre choix (par exemple, Générateur de code QR), et spécifiez un emplacement pour le nouveau projet dans le champ Emplacement. Ensuite, cliquez sur le bouton Suivant pour continuer.

Générateur de code QR .NET (Exemple de tutoriel de code), Figure 2 : Choisir un nom et un emplacement pour une nouvelle application console dans Visual Studio pour créer des codes QR.

Choisir un nom et un emplacement pour une nouvelle application console dans Visual Studio pour créer des codes QR

Choisissez un .NET Framework dans le menu déroulant Framework (ici, nous utilisons .NET 6.0 (Support à long terme)) et cliquez sur Créer.

Générateur de code QR .NET (Exemple de tutoriel de code), Figure 3 : Création de la nouvelle application de console dans Visual Studio sous le framework .NET 6.0

Création de la nouvelle application console dans Visual Studio sous le framework .NET 6.0

Etape 2. Installer la bibliothèque de codes-barres

2.1 Utilisation d'IronBarcode

Vous pouvez télécharger et installer la bibliothèque IronBarcode de quatre façons.

Ces moyens sont les suivants :

  • Utilisation de l'interface utilisateur du gestionnaire de paquets NuGet de Visual Studio,
  • Utilisation de la console du gestionnaire de paquets de Visual Studio,
  • En le téléchargeant directement depuis le site web de NuGet, ou
  • En le téléchargeant directement sur le site d'IronBarcode.

2.1.1 Utilisation de l'interface utilisateur du gestionnaire de paquets de Visual Studio

Dans la barre de menu, allez à Outils > Gestionnaire de packages NuGet > Gérer les packages NuGet pour la solution... pour ouvrir l'interface utilisateur du Gestionnaire de Packages.

Générateur de code QR .NET (Exemple de tutoriel de code), Figure 4 : Installation de la bibliothèque IronBarcode à l'aide de l'interface du gestionnaire de packages NuGet de Visual Studio.

Installer la bibliothèque IronBarcode en utilisant l'interface du gestionnaire de packages NuGet de Visual Studio

Alternativement, vous pouvez cliquer avec le bouton droit sur le nom de votre projet dans la fenêtre de l'Explorateur de solutions et sélectionner Gérer les packages NuGet... dans le menu contextuel.

Cliquez sur l'onglet Parcourir, et saisissez Barcode dans le champ de recherche. Sélectionnez IronBarcode dans la liste des packages associés (affiché comme le premier résultat dans l'image ci-dessous), choisissez votre projet dans le panneau de droite et cliquez sur le bouton Installer.

Générateur de code QR .NET (Exemple de tutoriel de code), Figure 5 : Recherche de la bibliothèque IronBarcode dans l'interface utilisateur du gestionnaire de packages. Elle apparaîtra probablement avant toutes les autres bibliothèques dans les résultats de la recherche.

Recherche de la bibliothèque IronBarcode dans l'interface utilisateur du gestionnaire de packages. Il apparaîtra très probablement avant toutes les autres bibliothèques dans les résultats de recherche

2.1.2 Utilisation de la console du gestionnaire de paquets de Visual Studio

Accédez à Outils > Gestionnaire de packages NuGet > Console du gestionnaire de packages. Saisissez la commande suivante dans le panneau de la ligne de commande qui s'affiche et appuyez sur ENTRÉE :

Install-Package BarCode

La commande ci-dessus télécharge et installe la bibliothèque dans le projet en cours.

2.1.3 Télécharger la bibliothèque depuis le site NuGet

Recherchez la page de la bibliothèque Barcode sur le site NuGet Gallery dans votre navigateur, (ou cliquez sur ce lien du package NuGet BarCode pour accéder directement à la page).

Cliquez sur le lien Télécharger le package dans le menu sur le côté droit pour enregistrer la bibliothèque sur votre ordinateur. Ensuite, double-cliquez sur la bibliothèque téléchargée depuis votre gestionnaire de fichiers pour l'installer automatiquement dans votre projet. Enfin, rechargez votre projet et il sera prêt à fonctionner.

2.1.4 Télécharger la bibliothèque à partir du site Web d'IronBarcode

Cliquez sur la page d'accueil d'IronBarcode pour télécharger la dernière DLL de code-barres .NET. Une fois téléchargé, suivez les étapes ci-dessous pour ajouter le paquet à votre projet :

  1. Faites un clic droit sur le projet dans le Panneau de l'explorateur de solutions, puis cliquez sur Ajouter > Référence COM.

    Générateur de code QR .NET (Exemple de code Tutoriel), Figure 6 : Ajout de la DLL IronBarcode directement dans le projet depuis Visual Studio.

    Ajout de la DLL IronBarcode dans le projet directement depuis Visual Studio

  2. Cliquez sur le bouton Parcourir et naviguez jusqu'à l'emplacement où vous avez extrait la DLL. Une fois la DLL sélectionnée, cliquez sur OK pour l'ajouter à votre projet.

    Générateur de code QR .NET (Exemple de tutoriel de code), Figure 7 : Insertion de la DLL IronBarcode comme nouvelle référence COM dans votre projet.

    Insérer la DLL IronBarcode comme nouvelle référence COM dans votre projet

Étape 3. Générer une image de code QR

3.1 Utilisation d'IronBarcode dans une application Windows/Console

Générez un nouveau code QR en invoquant la méthode CreateQrCode de la classe QRCodeWriter :

QRCodeWriter.CreateQrCode("hello world", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium, 0).SaveAsPng("MyQR.png");
QRCodeWriter.CreateQrCode("hello world", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium, 0).SaveAsPng("MyQR.png");
QRCodeWriter.CreateQrCode("hello world", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium, 0).SaveAsPng("MyQR.png")
$vbLabelText   $csharpLabel

La méthode CreateQrCode accepte un paramètre obligatoire, qui est les données à encoder dans l'image du code (peut être une String ou un Stream). La méthode accepte également trois paramètres facultatifs :

  1. La largeur et la hauteur du graphique (500px par 500px par défaut)

  2. Un niveau de correction d'erreur. IronBarcode propose quatre niveaux de correction d'erreur : Bas, Moyen, Élevé et Très Élevé. Par défaut, CreateQrCode utilise le niveau de correction le plus élevé QRCodeWriter.QrErrorCorrectionLevel.Highest

  3. Un numéro de version du symbole QR. Voir cette page pour une liste des versions valides. Une valeur de 0 (la valeur par défaut) indique à la méthode d'utiliser le numéro de version correct basé sur les données qu'elle va encoder.

    L'exemple ci-dessus génère un graphique de 500 pixels par 500 pixels en utilisant le niveau moyen de correction des erreurs. L'appel suivant à la méthode SaveAsPng sur le code QR généré le sauvegarde sous forme de fichier PNG à un emplacement de fichier spécifié.

    Générateur de code QR .NET (Exemple de tutoriel de code), Figure 8 : Le résultat de l'appel de QrCodeWriter.CreateQrCode utilisant les paramètres mentionnés ci-dessus.

    Le résultat de l'appel de QrCodeWriter.CreateQrCode en utilisant les paramètres susmentionnés

    Ensuite, l'exemple de code ci-dessous utilise la méthode CreateQrCodeWithLogo pour ajouter un logo d'entreprise à un code QR généré, un scénario d'utilisation typique pour toute entreprise.

var qrWithLogo = QRCodeWriter.CreateQrCodeWithLogo("Hello World", "qrlogo.png",500);
qrWithLogo.ChangeBarCodeColor(System.Drawing.Color.DarkRed);
qrWithLogo.SaveAsPng("Logo_QR_Code.png");
var qrWithLogo = QRCodeWriter.CreateQrCodeWithLogo("Hello World", "qrlogo.png",500);
qrWithLogo.ChangeBarCodeColor(System.Drawing.Color.DarkRed);
qrWithLogo.SaveAsPng("Logo_QR_Code.png");
Dim qrWithLogo = QRCodeWriter.CreateQrCodeWithLogo("Hello World", "qrlogo.png",500)
qrWithLogo.ChangeBarCodeColor(System.Drawing.Color.DarkRed)
qrWithLogo.SaveAsPng("Logo_QR_Code.png")
$vbLabelText   $csharpLabel

Dans l'exemple ci-dessus, une valeur String de "Hello, World" est encodée dans un nouveau code QR qui intègre une image située à un chemin de fichier spécifié. L'image est automatiquement dimensionnée pour s'adapter à la grille carrée du code QR, en étant alignée sur la taille qui permettra aux lecteurs de code QR de continuer à lire les données du code pur.

La ligne de code suivante ci-dessus utilise la méthode ChangeBarCodeColor pour changer la couleur du code QR en rouge foncé. Nous effectuons ici la coloration en utilisant l'un des types de classe de couleur du système disponibles fournis par C# (à savoir, System.Drawing.Color.DarkRed). Il est possible de spécifier des couleurs dans la notation hexadécimale HTML, comme le montre la ligne de code ci-dessous :

qrWithLogo.ChangeBarCodeColor(System.Drawing.ColorTranslator.FromHtml("#8B0000"));
qrWithLogo.ChangeBarCodeColor(System.Drawing.ColorTranslator.FromHtml("#8B0000"));
qrWithLogo.ChangeBarCodeColor(System.Drawing.ColorTranslator.FromHtml("#8B0000"))
$vbLabelText   $csharpLabel

La dernière ligne de code de l'exemple ci-dessus appelle la méthode SaveAsPng pour enregistrer le code QR en tant que fichier PNG. Les codes QR peuvent être enregistrés dans d'autres formats de fichiers tels que HTML :

qrWithLogo.SaveAsHtmlFile("test.html");
qrWithLogo.SaveAsHtmlFile("test.html");
qrWithLogo.SaveAsHtmlFile("test.html")
$vbLabelText   $csharpLabel

Consultez cette page de documentation pour une liste complète des types de fichiers dans lesquels les codes QR peuvent être enregistrés.

Générateur de codes QR .NET (Tutoriel d'exemple de code), Figure 9 : Générez des codes QR de différentes couleurs, dans différents formats de fichier, et en utilisant différentes images grâce aux méthodes disponibles dans la classe QRCodeWriter de IronBarcode.

Générez des codes QR de différentes couleurs, dans différents formats de fichiers, et en utilisant différentes images avec les méthodes disponibles dans la classe QRCodeWriter d'IronBarcode

3.2 Utilisation d'IronBarcode dans une application Web

La ligne de code montre comment IronBarcode peut être utilisé dans une application Web MVC .NET :

public IActionResult Index()
{
    QRCodeWriter.CreateQrCode("hello world", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium, 0).SaveAsPdf("Demo.png");
    return File("Demo.png", "image/png", "Demo.png", true);
}
public IActionResult Index()
{
    QRCodeWriter.CreateQrCode("hello world", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium, 0).SaveAsPdf("Demo.png");
    return File("Demo.png", "image/png", "Demo.png", true);
}
Public Function Index() As IActionResult
	QRCodeWriter.CreateQrCode("hello world", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium, 0).SaveAsPdf("Demo.png")
	Return File("Demo.png", "image/png", "Demo.png", True)
End Function
$vbLabelText   $csharpLabel

L'exemple ci-dessus fonctionne de manière très similaire aux exemples précédents. Un code QR est d'abord généré, puis renvoyé au client dans le corps de la réponse.

Conclusion

IronBarcode est l'une des bibliothèques les plus rapides et les plus puissantes disponibles pour lire et écrire des codes-barres. Cette bibliothèque simple est prise en charge par différents systèmes d'exploitation, elle supporte de nombreux formats de codes-barres et elle est facile à utiliser.

Les informations de licence et légales pour l'utilisation d'IronBarcode peuvent être trouvées sur la page de licence. L'utilisation d'IronBarcode est gratuite sous la licence Free Developer License. La licence développeur premium (payante) comprend un an de support gratuit et de mises à jour du produit.

Jordi Bardia
Ingénieur logiciel
Jordi maîtrise parfaitement Python, C# et C++. Lorsqu'il ne met pas à profit ses compétences chez Iron Software, il se consacre à la programmation de jeux. Partageant des responsabilités en matière de tests de produits, de développement de produits et de recherche, Jordi apporte une valeur ajoutée considérable à l'amélioration continue des produits. Cette expérience variée le stimule et l'engage, et il dit que c'est l'un des aspects qu'il préfère dans son travail chez Iron Software. Jordi a grandi à Miami, en Floride, et a étudié l'informatique et les statistiques à l'université de Floride.
< PRÉCÉDENT
Tutoriel sur le lecteur de codes-barres C#, étape par étape
SUIVANT >
Comment générer un code QR dans les applications Windows C#