UTILISATION D'IRONQR

Lecteur de code QR C# (Tutoriel étape par étape)

Jordi Bardia
Jordi Bardia
février 23, 2022
Partager:

La génération à la demande de codes-barres nouveaux et variés est un aspect crucial de nombreuses applications commerciales .NET. La bibliothèque IronBarcode rend cette opération très rapide, pratique et facile par rapport à d'autres options tierces. Ce tutoriel vise à illustrer comment cela se passe.

1. Création d'un nouveau projet

Ouvrez Visual Studio et allez dans le menu Fichier. Sélectionnez Nouveau projet, puis sélectionnez Application Console/Formulaires Windows/Application WPF. Les codes-barres peuvent également être utilisés dans tous les types d'applications. En outre, vous pouvez les utiliser avec des applications telles que Webform/MVC/MVC Core.

Lecteur de code QR C# (Tutoriel étape par étape), Figure 1 : Configurez votre nouveau projet

Configurez votre nouveau projet

Saisissez le nom du projet et sélectionnez le chemin d'accès au fichier dans la zone de texte appropriée de Visual Studio. Ensuite, cliquez sur le bouton Create, et sélectionnez également le .NET Framework requis. Le projet va maintenant générer la structure de l'application sélectionnée. Si vous avez sélectionné l'Application Console, le fichier program.cs s'ouvrira maintenant, où vous pourrez entrer le code et créer/exécuter l'application.

2. Installer le paquet NuGet IronBarcode

Maintenant, allez dans l'Explorateur de solutions de Visual Studio et cliquez avec le bouton gauche sur le projet. Dans le menu contextuel, sélectionnez le Gestionnaire de paquets NuGet dans le menu et recherchez "Barcode" comme mot-clé. Sélectionnez le premier résultat dans la boîte de dialogue NuGet Package et cliquez sur l'option d'installation.

Lecteur de code QR C# (Tutoriel étape par étape), Figure 2 : Installer la bibliothèque IronBarcode depuis le gestionnaire de packages NuGet

Installer la bibliothèque IronBarcode depuis le Gestionnaire de packages NuGet

Alternativement, dans Visual Studio, suivez ces instructions : Allez dans Outils > Gestionnaire de packages NuGet > Console du gestionnaire de packages

Ouvrez l'onglet Console du Gestionnaire de Paquets. Tapez la ligne ci-dessous :

Install-Package IronQR

Lecteur de code QR C# (Tutoriel étape par étape), Figure 3 : Console du gestionnaire de packages NuGet

Console du Gestionnaire de Packages NuGet

Consultez le lien suivant pour en savoir plus sur la dernière version du Barcode Reader SDK.

https://www.nuget.org/packages/barcode

Ensuite, le paquet téléchargera tous les fichiers DLL et ajoutera également la référence du fichier DLL dans le projet actuel en tant que référence du projet .NET.

Le projet Visual Studio est maintenant prêt à être utilisé sur le code.

3. Ajout d'une référence

Ajoutez la référence IronBarCode au code comme indiqué ci-dessous, permettant l'utilisation des fonctions disponibles dans la bibliothèque IronBarcode dans .NET Core. Pour en savoir plus sur le contrôle du lecteur de code-barres, la lecture des codes QR, les composants, la prise en charge des types de codes QR et la compatibilité du SDK du lecteur de code-barres, veuillez vous référer à ce lien : https://ironsoftware.com/csharp/barcode/

using IronBarCode;

4. Création d'une instance de code-barres

BarcodeReader est la classe statique utilisée pour lire/créer des codes QR. Il peut être utilisé sans créer d'instance d'objet pour la classe statique BarcodeReader. Le contrôle de lecteur de code-barres offre la possibilité de scanner 15 types de codes-barres en utilisant une seule fonction Read ou ReadAsync. La bibliothèque IronBarcode permet de lire les codes QR/codes-barres provenant de diverses sources :

  • Chaîne
  • Flux
  • Image
  • Bitmap

5. Lire le code-barres en utilisant String

Les codes QR et les images de codes-barres peuvent être lus facilement à l'aide de la bibliothèque de lecture de codes-barres .NET. La méthode Read est une fonction statique qui va scanner les images QR code et décoder les QR codes et les codes-barres en texte. Il accepte différents types de fichiers d'images comme les bitmaps, les fichiers PNG, JPEG, TIFF, etc.

Cette fonction Read extrait les données du code QR/barcode de l'image et récupère le résultat sous la forme de l'objet BarcodeResult. Si le fichier image n'est pas reconnu par le code, celui-ci renverra null.

Le BarcodeResult a les valeurs suivantes :

  • Type de code-barres
  • Valeur
  • Texte
  • Valeur binaire

    BarcodeType est un type de données enum qui retourne le type de code-barres de l'image d'entrée donnée. IronBarcode prend en charge vingt-deux types de codes-barres. Il renvoie le type de code-barres appliqué à l'image d'entrée donnée.

    La valeur et le texte sont également les types d'objets disponibles sur le BarcodeResult. La valeur et le texte sont tous deux des types de données de type chaîne. Cela renvoie la valeur du code-barres sous forme de chaîne de caractères. La méthode Read lira les codes QR et les codes-barres et obtiendra la valeur en chaîne de l'image de code-barres donnée en valeur/texte. La valeur binaire est le type de données octet et renvoie l'octet de l'image donnée. Vous trouverez ci-dessous le code de réponse rapide qui peut être copié dans n'importe quelle application .NET Windows Forms ou .NET Standard.

BarcodeResult result = BarcodeReader.Read("test.bmp");
// Assert that IronBarCode Works :-)
if (result != null && result.Text == "https://ironsoftware.com/csharp/barcode")
{
    System.Console.WriteLine("Success");
}
BarcodeResult result = BarcodeReader.Read("test.bmp");
// Assert that IronBarCode Works :-)
if (result != null && result.Text == "https://ironsoftware.com/csharp/barcode")
{
    System.Console.WriteLine("Success");
}
Dim result As BarcodeResult = BarcodeReader.Read("test.bmp")
' Assert that IronBarCode Works :-)
If result IsNot Nothing AndAlso result.Text = "https://ironsoftware.com/csharp/barcode" Then
	System.Console.WriteLine("Success")
End If
$vbLabelText   $csharpLabel

Le code ci-dessus montre comment lire les codes QR et les codes-barres à l'aide de la bibliothèque de lecture de codes-barres .NET. Le code est simple à utiliser et permet de faire correspondre un fichier du système à un objet Bitmap. Il décode également le code QR/le code-barres à partir de l'image et affiche le résultat dans l'objet. Vous trouverez ci-dessous les codes QR/codes-barres fournis dans le code à scanner pour obtenir les données encodées.

Lecteur de code QR C# (Tutoriel étape par étape), Figure 4 : L'entrée du code-barres

La saisie du code-barres

6. Lecture de plusieurs codes-barres à partir d'une image TIFF

Le contrôle de lecteur de code-barres .NET permet la lecture de plusieurs codes QR/codes-barres à partir d'un fichier image en utilisant la même méthode Read, qui est très facile à utiliser.

Vous trouverez ci-dessous un exemple de code permettant de lire plusieurs codes QR à partir d'une image :

// Configure options
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    ExpectBarcodeTypes = BarcodeEncoding.Code128,
    ExpectMultipleBarcodes = true,
};

BarcodeResult [] multiFrameResults = BarcodeReader.Read("Multiframe.tiff", options);
// Configure options
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    ExpectBarcodeTypes = BarcodeEncoding.Code128,
    ExpectMultipleBarcodes = true,
};

BarcodeResult [] multiFrameResults = BarcodeReader.Read("Multiframe.tiff", options);
' Configure options
Dim options As New BarcodeReaderOptions() With {
	.ExpectBarcodeTypes = BarcodeEncoding.Code128,
	.ExpectMultipleBarcodes = True
}

Dim multiFrameResults() As BarcodeResult = BarcodeReader.Read("Multiframe.tiff", options)
$vbLabelText   $csharpLabel

Dans le code ci-dessus, les codes QR sont extraits d'images de codes QR TIFF. Le lecteur de codes-barres .NET scanne les codes QR à partir de l'image du système et renvoie le résultat sous la forme d'un tableau. Dans le code ci-dessus, le code-barres pour Code128 est le seul type analysé. Si d'autres codes-barres sont présents sur l'image, ils seront ignorés.

7. Lecture de codes QR et de codes-barres à partir de PDF

Cette section explique comment lire le code QR à partir de documents PDF. La bibliothèque de codes QR analysera toutes les pages et tous les fichiers disponibles pour y trouver tous les codes QR disponibles, ou se concentrera sur un type spécifique de code-barres. Lorsqu'on utilise IronBarcode, la bibliothèque fournit toutes les DLL nécessaires à un lecteur de codes-barres standard. Il n'est donc pas nécessaire d'inclure d'autres DLL dans les références d'un projet .NET.

Vous trouverez ci-dessous un exemple de code de copie qui peut être utilisé pour lire les codes QR/codes-barres à partir d'un PDF.

PagedBarcodeResult [] pagedResults = BarcodeReader.ReadPdf("MultipleBarcodes.pdf");
// Work with the results
foreach (PagedBarcodeResult pageRes in pagedResults)
{
    int pageNumber = pageRes.PageNumber;
    string value = pageRes.Value;
    Bitmap img = pageRes.BarcodeImage;
    BarcodeEncoding barcodeType = pageRes.BarcodeType;
    byte [] binary = pageRes.BinaryValue;
    Console.WriteLine(pageRes.Value);
}
PagedBarcodeResult [] pagedResults = BarcodeReader.ReadPdf("MultipleBarcodes.pdf");
// Work with the results
foreach (PagedBarcodeResult pageRes in pagedResults)
{
    int pageNumber = pageRes.PageNumber;
    string value = pageRes.Value;
    Bitmap img = pageRes.BarcodeImage;
    BarcodeEncoding barcodeType = pageRes.BarcodeType;
    byte [] binary = pageRes.BinaryValue;
    Console.WriteLine(pageRes.Value);
}
Dim pagedResults() As PagedBarcodeResult = BarcodeReader.ReadPdf("MultipleBarcodes.pdf")
' Work with the results
For Each pageRes As PagedBarcodeResult In pagedResults
	Dim pageNumber As Integer = pageRes.PageNumber
	Dim value As String = pageRes.Value
	Dim img As Bitmap = pageRes.BarcodeImage
	Dim barcodeType As BarcodeEncoding = pageRes.BarcodeType
	Dim binary() As Byte = pageRes.BinaryValue
	Console.WriteLine(pageRes.Value)
Next pageRes
$vbLabelText   $csharpLabel

Le code ci-dessus est un exemple pour lire des codes QR/codes-barres à partir d'un fichier PDF à l'aide d'une méthode simple ReadPdf. Il peut également fournir des résultats détaillés pour chaque code-barres et son type.

Conclusion

les lecteurs de codes-barres .NET offrent un moyen simple et facile de lire les codes QR ou de décoder/créer des codes QR et des codes-barres en suivant des étapes simples. L'IronBarcode DLL peut être utilisé dans divers environnements tels que les applications Windows Forms .NET, les applications mobiles, les applications Web, MAUI et Blazor en utilisant le .NET Framework ou .NET Standard. De plus, IronBarcode offre un large éventail d'options de personnalisation pour améliorer la vitesse de lecture des codes-barres, telles que les régions de recadrage ou le multithreading, et la précision du modèle ML. IronBarcode offre une clé d'essai gratuite, ou vous pouvez actuellement acheter cinq produits d'Iron Software pour le prix de deux seulement.

Visitez la page de licences pour plus d'informations.

Vous pouvez également télécharger un projet de fichier zip.

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
Comment créer un code QR en VB .NET