Créer des codes QR personnalisables est un moyen puissant de fournir des liens, des identifiants et des app-deep tout en restant sur la marque. Avec Aspose.BarCode pour .NET, vous pouvez corriger les erreurs de tonne, la taille du module, les couleurs et les formats de sortie pour répondre à la fois aux besoins fonctionnels et esthétiques. Cet article ajustera les instructions de pas à pas avec le gist au bout et ajoute des conseils pratiques, gotchas et améliorations facultatives.

Principaux

  • .NET 8 (ou .Net 6+) SDK
  • Accès à l’accès (Aspose.BarCode)
  • Connaissance de base avec System.Drawing
  • (Optionnel) Objectif de sortie à haute résolution pour les cas d’utilisation imprimés

Créer un projet et ajouter le package

dotnet new console -n CustomizableQRCodeExample -f net8.0
cd CustomizableQRCodeExample
dotnet add package Aspose.BarCode

Exemple complet

using System;
using System.Drawing;
using Aspose.BarCode.Generation;

namespace CustomizableQRCodeExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Step 1: Create a QR code generator with specific settings
            var qrGenerator = new BarcodeGenerator(EncodeTypes.QR, "https://www.aspose.com");

            // Step 2: Configure QR code properties
            qrGenerator.Parameters.Barcode.QR.CodeText = "https://www.aspose.com";
            qrGenerator.Parameters.Barcode.QR.ErrorLevel = QRErrorLevelLevel.High;
            qrGenerator.Parameters.Barcode.QR.ModuleSize = 5;
            qrGenerator.Parameters.Barcode.XDimension.Pixels = 2;

            // Step 3: Customize colors
            qrGenerator.Parameters.Barcode.ForegroundColor = Color.Black;
            qrGenerator.Parameters.Barcode.BackgroundColor = Color.White;

            // Step 4: Generate and save the QR code as an image
            using (var image = qrGenerator.GenerateBarCodeImage())
            {
                image.Save("CustomQRCode.png");
                Console.WriteLine("QR Code generated successfully!");
            }
        }
    }
}

Étape par étape (Mapé à l’exemple)

Étape 1 : Démarrer le générateur QR

Créer un générateur avec EncodeTypes.QR et une charge payante par défaut (URL, ID, etc.).

var qrGenerator = new BarcodeGenerator(EncodeTypes.QR, "https://www.aspose.com");

Vous pouvez définir le contenu soit par le constructeur ou Parameters.Barcode.QR.CodeTextL’exemple donne les deux pour la clarté.

Étape 2 : Configurer les propriétés QR de base

  • Texte de code: les données réelles encodées dans le QR.
  • ** Correction d’erreur**: contrôle la résilience (par exemple, les bouchons, logos sur le code).
  • ** Module / taille cellulaire** : la taille de chaque carré « module ».
qrGenerator.Parameters.Barcode.QR.CodeText = "https://www.aspose.com";
qrGenerator.Parameters.Barcode.QR.ErrorLevel = QRErrorLevelLevel.High; // robust against damage
qrGenerator.Parameters.Barcode.QR.ModuleSize = 5;                       // pixels per module (visual density)
qrGenerator.Parameters.Barcode.XDimension.Pixels = 2;                   // base module thickness (kept to match gist)

**Note : ** Pour QR, paramètres QR.ModuleSize Il est généralement suffisant. l’exemple donne également XDimension.Pixels pour le miroir de l’ail ; si vous n’arrivez qu’un, préférez QR.ModuleSize Pour une scale visuelle prévisible.

Étape 3 : Appliquer les couleurs de la marque (Forréground / Background)

qrGenerator.Parameters.Barcode.ForegroundColor = Color.Black;
qrGenerator.Parameters.Barcode.BackgroundColor = Color.White;

Pour une fiabilité maximale, assurez un contraste adéquat.Si vous inversez les couleurs ou placez sur des fonds occupés, ajoutez une zone calme généreuse (marge).

Étape 4 : Render & Save

Générer A System.Drawing.Image et sauvegarde comme PNG (sharp, sans perte).

using (var image = qrGenerator.GenerateBarCodeImage())
{
    image.Save("CustomQRCode.png");
}

Améliorations facultatives

A) Exportation à plusieurs formats

using System.Drawing.Imaging;

// After GenerateBarCodeImage():
image.Save("CustomQRCode.jpg", ImageFormat.Jpeg);  // for photos/CMYK workflows
image.Save("CustomQRCode.bmp", ImageFormat.Bmp);   // uncompressed (big files)

• Augmentation de la lecture d’impression

  • Scale up : augmentation QR.ModuleSize (par exemple, 6 à 10) pour les impressions physiques.
  • Zone Quiet: assurez un espace blanc suffisant autour du code; si votre outil de layout est trop proche, ajoutez le tapis à l’image.
    • Correction d’erreur de haute qualité * : maintenir High Si vous placez de petits logos ou d’imprimer sur des surfaces texturées.

b) Les variantes de paiement intégrées

    • Les liens d’application : myapp://open?id=12345
  • • Configuration Wi-Fi : WIFI:T:WPA;S:MySSID;P:MyPassword;H:false;
    • Le vCard : BEGIN:VCARD\nVERSION:3.0\nN:…\nEND:VCARD

Troubleshooting

  • ** Le scanner ne lit pas**: Augmenter le contraste (front noir, fond lumineux), grandir ModuleSizeAssurez-vous d’une zone tranquille.
  • Blurry à petites tailles: Évitez JPEG pour les petits codes; préférez PNG et modules plus grands.
  • Logo overlay: Gardez-le petit et centralisé; reliez-vous à High Correction d’erreur à compenser.

Migliori pratiche

  • Validation du contenu: Valider les URL/IDs avant l’incorporation afin d’éviter les codes QR stables en imprimant.
  • Contrôle de la version: Gardez les paramètres du générateur dans le code (ou config) et communiquez-les – matière de sortie reproductible dans la marque.
  • Parité environnementale: Si vous rendrez sur CI, utilisez le même stack DPI/font pour éviter les différences de raster subtiles.

Conclusion

Avec Aspose.BarCode pour .NET, vous pouvez créer des codes QR qui ne sont pas seulement robust (via correction d’erreur) mais aussi on-brand(via taille et contrôle des couleurs). ModuleSize, correction d’erreur, et les couleurs pour correspondre à votre médium de livraison - écran, étiquette, ou billboard.

More in this category