Criar códigos QR personalizáveis é uma maneira poderosa de fornecer links, IDs e aplicativos-deep links enquanto permanece na marca. com Aspose.BarCode para .NET, você pode corrigir erros, tamanho de módulo, cores e formatos de saída para atender às necessidades funcionais e estéticas. Este artigo alinhará as instruções passo a passo com o gist no final e adiciona dicas práticas, gotchas e melhorias opcionais.

Pré-requisitos

  • .NET 8 (ou .Net 6+) SDK
  • Acesso à Internet (Aspose.BarCode)
  • Conhecimento básico com System.Drawing
  • (Opcional) Objetivo de saída de alta resolução para casos de utilização de impressão

Crie um projeto e adicione o pacote

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

Exemplo completo

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!");
            }
        }
    }
}

Passo a passo (mapeado para o exemplo)

Passo 1: Iniciar o gerador QR

Crie um gerador com EncodeTypes.QR e uma carga de pagamento padrão (URL, ID, etc.).

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

Você pode configurar o conteúdo através do fabricante ou Parameters.Barcode.QR.CodeTextO exemplo estabelece os dois para a clareza.

Passo 2: Configure Propriedades QR Core

  • Texto de código: os dados reais codificados no QR.
  • ** Correção de erro**: controla a resiliência (por exemplo, esmagamentos, logos sobre o código).
  • Módulo / Célula Tamanho: o tamanho de cada quadrado “modulo”.
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)

**Nota: ** Para QR, configuração QR.ModuleSize Isso é muito importante.O exemplo também XDimension.Pixels para espelhar o gesto; se você tonificar apenas um, prefira QR.ModuleSize para uma escalada visual previsível.

Passo 3: Aplique as cores da marca (Foreground/Background)

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

Para a máxima fiabilidade do scan, certifique-se de um contraste adequado.Se você inverter cores ou colocar em fundos ocupados, adicione uma zona generosa de silêncio (margem).

Etapa 4: Render e salvar

geração a System.Drawing.Image e salvar como PNG (sharp, sem perda).

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

Melhorias opcionais

A) Exportação em vários formatos

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)

Aumentar a leitura de impressão

    • Aumentar a escala: elevar QR.ModuleSize (por exemplo, 6-10) para impressões físicas.
  • Zona Quiet: forneça espaço branco suficiente ao redor do código; se a ferramenta de layout estiver muito próxima, adicione um tapete à imagem.
    • Correção de erros elevados**: mantenha High se colocar pequenos logos ou imprimir em superfícies texturadas.

c) Variantes de pagamento embutidos

    • Linhas de aplicativo *: myapp://open?id=12345
  • • Configuração de Wi-Fi: WIFI:T:WPA;S:MySSID;P:MyPassword;H:false;
    • Cadeia do VC: BEGIN:VCARD\nVERSION:3.0\nN:…\nEND:VCARD

Troubleshooting

  • O scanner não vai ler: aumentar o contraste (fonte escuro, fundo claro), crescer ModuleSizePara garantir uma zona limpa e tranquila.
  • Blurry em tamanhos pequenos: Evite JPEG para códigos pequenos; prefira PNG e módulos maiores.
  • Logo overlay: Mantenha-o pequeno e centrado; confia em High Correção de erros para compensar.

Melhores Práticas

  • Validação de conteúdo: Valida URLs/IDs antes de inserir para evitar códigos QR em impressão.
  • Controlar a versão: Mantenha as configurações do gerador em código (ou config) e comprometa-as – substância de saída reprodutível na marcação.
  • Paridade Ambiental: Se você render em CI, use o mesmo DPI/font stack para evitar diferenças sutis de raster.

Conclusão

Com o Aspose.BarCode para .NET, você pode criar códigos QR que não são apenas robust (via correção de erro) mas também on-brand(via tamanho e controle de cor). ModuleSizeCorreção de erros, e cores para se adequar ao seu meio de entrega – tela, rótulo ou billboard.

More in this category