Código QR .NET Core: Leia e gere códigos QR em C#

Como você instala a biblioteca de código QR?

Instalar o IronQR via NuGet leva segundos. Abra o Visual Studio, vá para Ferramentas > Gerenciador de Pacotes NuGet > Gerenciar Pacotes NuGet para Solução, procure por IronQR e clique em Instalar. O pacote tem dependências mínimas e é compatível com Windows, macOS e Linux de imediato.

Install-Package IronQR

O IronQR tem como alvo .NET Core 6, 7, 8, 9, e 10, bem como .NET Framework 4.6.2 e posteriores. Para projetos multiplataforma, uma integração SkiaSharp lida com o processamento de imagem em runtimes não Windows. A biblioteca funciona com aplicações web ASP.NET Core, aplicativos de console e soluções desktop sem configuração adicional de tempo de execução. Uma vez instalado, todos os métodos de extensão e tipos necessários estão disponíveis imediatamente.

Como Ler um Código QR Básico de uma Imagem?

Ler dados de código QR a partir de arquivos de imagem requer apenas algumas linhas de código. A classe QrReader utiliza um modelo avançado de aprendizado de máquina que avalia a qualidade da imagem e seleciona automaticamente o modo de segmento correto, fornecendo resultados precisos mesmo quando a imagem de entrada não é ideal.

using IronQr;
using IronSoftware.Drawing;

// Load image containing QR code
var inputBmp = AnyBitmap.FromFile("qr-sample.png");
// Create QrImageInput from the bitmap
QrImageInput imageInput = new QrImageInput(inputBmp);
// Initialize QR Reader with ML model
QrReader reader = new QrReader();
// Read and decode all QR codes in the image
IEnumerable<QrResult> results = reader.Read(imageInput);
// Output decoded text strings
foreach (var qrCode in results)
{
    Console.WriteLine($"QR Code Value: {qrCode.Value}");
    Console.WriteLine($"URL: {qrCode.Url}");
}

using IronQr;
using IronSoftware.Drawing;

// Load image containing QR code
var inputBmp = AnyBitmap.FromFile("qr-sample.png");
// Create QrImageInput from the bitmap
QrImageInput imageInput = new QrImageInput(inputBmp);
// Initialize QR Reader with ML model
QrReader reader = new QrReader();
// Read and decode all QR codes in the image
IEnumerable<QrResult> results = reader.Read(imageInput);
// Output decoded text strings
foreach (var qrCode in results)
{
    Console.WriteLine($"QR Code Value: {qrCode.Value}");
    Console.WriteLine($"URL: {qrCode.Url}");
}

Como Extrair Dados Avançados de um Código QR?

Além da decodificação de valor básico, IronQR expõe coordenadas, segmentos de dados brutos e informações em nível de módulo de cada símbolo escaneado. Isso é essencial para fluxos de trabalho de processamento de documentos onde você precisa saber exatamente onde um código QR apareceu na página, ou para aplicações que precisam lidar com vários códigos em uma única imagem.

using IronQr;
using IronSoftware.Drawing;

var inputBmp = AnyBitmap.FromFile("document-with-qr.png");
QrImageInput imageInput = new QrImageInput(inputBmp);
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);
foreach (var qrCode in results)
{
    // Access decoded value
    Console.WriteLine($"Data: {qrCode.Value}");
    // Get corner coordinate positions
    foreach (PointF point in qrCode.Points)
    {
        Console.WriteLine($"Position: {point.X}, {point.Y}");
    }
}

using IronQr;
using IronSoftware.Drawing;

var inputBmp = AnyBitmap.FromFile("document-with-qr.png");
QrImageInput imageInput = new QrImageInput(inputBmp);
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);
foreach (var qrCode in results)
{
    // Access decoded value
    Console.WriteLine($"Data: {qrCode.Value}");
    // Get corner coordinate positions
    foreach (PointF point in qrCode.Points)
    {
        Console.WriteLine($"Position: {point.X}, {point.Y}");
    }
}

Como os Níveis de Correção de Erros Afetam a Qualidade do Código QR?

A correção de erros é o mecanismo que permite que um scanner QR recupere os dados originais mesmo quando parte do código está obscurecida, impressa de forma ruim ou fisicamente danificada. O padrão Código QR define quatro níveis -- Baixo (L), Médio (M), Quartil (Q) e Alto (H) -- cada um trocando capacidade de armazenamento por tolerância a danos.

Ao gerar códigos QR, especificar um nível de correção de erros mais alto garante que a saída resista sob condições reais de escaneamento:

using IronQr;
using IronSoftware.Drawing;

// Configure QR options with high error correction
var qrOptions = new QrOptions(QrErrorCorrectionLevel.High, 20);
// Generate a QR code with specified error correction
QrCode myQr = QrWriter.Write("https://ironsoftware.com", qrOptions);
// Save as PNG image
AnyBitmap qrImage = myQr.Save();
qrImage.SaveAs("high-error-correction-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Configure QR options with high error correction
var qrOptions = new QrOptions(QrErrorCorrectionLevel.High, 20);
// Generate a QR code with specified error correction
QrCode myQr = QrWriter.Write("https://ironsoftware.com", qrOptions);
// Save as PNG image
AnyBitmap qrImage = myQr.Save();
qrImage.SaveAs("high-error-correction-qr.png");

Como Gerar Códigos QR com Caracteres Internacionais?

IronQR suporta a gama completa de modos de codificação QR: numérico, alfanumérico, byte e Kanji. Para texto japonês e outros conteúdos Unicode, a biblioteca seleciona automaticamente a codificação mais eficiente em termos de espaço:

using IronQr;
using IronSoftware.Drawing;

// Generate QR that encodes Japanese Unicode text
QrCode japaneseQr = QrWriter.Write("こんにちは世界");
// The library selects Kanji mode automatically
AnyBitmap qrImage = japaneseQr.Save();
qrImage.SaveAs("japanese-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Generate QR that encodes Japanese Unicode text
QrCode japaneseQr = QrWriter.Write("こんにちは世界");
// The library selects Kanji mode automatically
AnyBitmap qrImage = japaneseQr.Save();
qrImage.SaveAs("japanese-qr.png");

Como você utiliza geradores de carga útil para dados QR estruturados?

Um código QR que codifica uma URL simples funciona para compartilhamento de links, mas muitas aplicações precisam codificar dados estruturados -- credenciais de WiFi, cartões de contato no formato vCard ou dados de eventos. Formatar essas cargas úteis manualmente é propenso a erros; um ponto e vírgula faltando ou ordem incorreta dos campos fará com que os scanners interpretem mal os dados.

O IronQR fornece auxiliares de carga útil que constroem essas strings estruturadas corretamente:

using IronQr;
using IronSoftware.Drawing;

// Generate QR code with URL payload
var urlQrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
// Save QR as PNG image file
AnyBitmap qrImage = urlQrCode.Save();
qrImage.SaveAs("url-qr-code.png");
Console.WriteLine("QR code generated successfully.");

using IronQr;
using IronSoftware.Drawing;

// Generate QR code with URL payload
var urlQrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
// Save QR as PNG image file
AnyBitmap qrImage = urlQrCode.Save();
qrImage.SaveAs("url-qr-code.png");
Console.WriteLine("QR code generated successfully.");

Como Personalizar a Aparência do Código QR?

O IronQR dá a você controle sobre a aparência visual dos códigos gerados sem sacrificar a capacidade de escaneamento. Você pode mudar as cores de primeiro plano e de fundo, aplicar personalização de marca ou incorporar um logotipo na zona silenciosa no centro.

using IronQr;
using IronSoftware.Drawing;

// Define custom colors for the QR code
var darkColor = Color.FromArgb(30, 30, 120);   // Deep navy foreground
var lightColor = Color.White;

var options = new QrOptions(QrErrorCorrectionLevel.High, maxVersion: 20)
{
    BackgroundColor = lightColor,
    Color = darkColor,
    // Embed a logo image into the QR center
    Logo = AnyBitmap.FromFile("logo.png")
};

QrCode styledQr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap output = styledQr.Save();
output.SaveAs("branded-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Define custom colors for the QR code
var darkColor = Color.FromArgb(30, 30, 120);   // Deep navy foreground
var lightColor = Color.White;

var options = new QrOptions(QrErrorCorrectionLevel.High, maxVersion: 20)
{
    BackgroundColor = lightColor,
    Color = darkColor,
    // Embed a logo image into the QR center
    Logo = AnyBitmap.FromFile("logo.png")
};

QrCode styledQr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap output = styledQr.Save();
output.SaveAs("branded-qr.png");

Incorporar um logotipo reduz a área de dados efetiva, então a biblioteca exige nível de correção de errosHquando um logotipo é fornecido. A zona silenciosa reservada no centro representa cerca de 30% da superfície do código, que está dentro da capacidade de recuperação do nível H. A biblioteca impõe essa restrição automaticamente -- se você definir um nível de correção de erro mais baixo junto com um logotipo, o IronQR levanta uma exceção com uma mensagem descritiva ao invés de produzir um código que escaneia de forma não confiável.

Para aplicações ASP.NET Core, o tutorial do gerador de código QR ASP.NET Core mostra como servir códigos QR gerados como respostas de imagem a partir de uma ação do controlador. O stream de saída grava diretamente na resposta sem I/O de arquivo intermediário, o que mantém a latência baixa para endpoints de alto tráfego.

Como você lê códigos QR em uma aplicação ASP.NET Core?

Escanear códigos QR do lado do servidor -- de imagens carregadas, pipelines de processamento de documentos ou sistemas de inspeção automatizada -- é um caso de uso comum para a API de leitura. O guia de scanner de código QR ASP.NET cobre a configuração completa do controlador e serviço, mas o padrão de leitura principal é o mesmo que uma aplicação console:

using IronQr;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/qr")]
public class QrScanController : ControllerBase
{
    [HttpPost("scan")]
    public IActionResult Scan(IFormFile imageFile)
    {
        using var stream = imageFile.OpenReadStream();
        var bitmap = AnyBitmap.FromStream(stream);
        var imageInput = new QrImageInput(bitmap);
        var reader = new QrReader();
        var results = reader.Read(imageInput);

        var decoded = results.Select(r => new { r.Value, r.Url }).ToList();
        return Ok(decoded);
    }
}

using IronQr;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/qr")]
public class QrScanController : ControllerBase
{
    [HttpPost("scan")]
    public IActionResult Scan(IFormFile imageFile)
    {
        using var stream = imageFile.OpenReadStream();
        var bitmap = AnyBitmap.FromStream(stream);
        var imageInput = new QrImageInput(bitmap);
        var reader = new QrReader();
        var results = reader.Read(imageInput);

        var decoded = results.Select(r => new { r.Value, r.Url }).ToList();
        return Ok(decoded);
    }
}

O método AnyBitmap.FromStream() aceita qualquer fluxo legível, então o mesmo caminho de código funciona para arquivos carregados através de um formulário, imagens buscadas de armazenamento blob, ou quadros extraídos de um pipeline de vídeo. O controlador não grava arquivos temporários no disco, o que é importante para implantações em contêineres onde o sistema de arquivos pode ser somente leitura.

Para cenários de alta vazão, instancie QrReader uma vez por tempo de vida da aplicação como um singleton, já que o custo do carregamento do modelo de ML é pago na primeira construção. Chamadas subsequentes Read() na mesma instância são seguras para thread e compartilham o modelo carregado.

Como você gera códigos QR em uma aplicação .NET MAUI?

O tutorial de código QR .NET MAUI demonstra geração multiplataforma completa em iOS, Android, macOS e Windows. O IronQR usa o backend de renderização SkiaSharp ao rodar em plataformas não Windows, garantindo saída consistente em todos os alvos MAUI.

using IronQr;
using IronSoftware.Drawing;

// Generate QR and convert to a byte array for display in MAUI
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap bitmap = qr.Save();
byte[] imageBytes = bitmap.ExportBytes();

// Bind imageBytes to an <Image Source> in your MAUI page

using IronQr;
using IronSoftware.Drawing;

// Generate QR and convert to a byte array for display in MAUI
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap bitmap = qr.Save();
byte[] imageBytes = bitmap.ExportBytes();

// Bind imageBytes to an <Image Source> in your MAUI page

Em alvos móveis, ExportBytes() retorna um array de bytes PNG que você pode alimentar diretamente em um StreamImageSource ou gravar em um ImageButton. O scaffold MAUI não requer caminhos de código específicos da plataforma -- a mesma lógica de geração roda idêntica em todos os quatro alvos MAUI.

Para projetos VB.NET a superfície da API é idêntica; apenas a sintaxe difere. A biblioteca fornece um único pacote NuGet sem necessidade de montagem VB.NET separada.

Quais são os seus próximos passos?

O IronQR cobre o ciclo de vida completo do código QR no .NET -- desde a geração básica e codificação de carga útil estruturada até leitura movida a ML de códigos danificados ou com marca. A biblioteca lida com codificação Kanji, configuração de correção de erros e saída de imagem multiplataforma, deixando você focar na lógica específica para sua aplicação.

Para colocar em prática o que você aprendeu:

• Revise o tutorial de leitor de código QR C# para um olhar mais profundo na API de leitura e processamento de resultados.
• Trabalhe através do tutorial de aplicação geradora de código QR C# para um walkthrough completo do projeto.
• Navegue pelos exemplos de código para ver padrões adicionais de geração e leitura.
• Compre uma licença IronQR para desbloquear todos os recursos para implantação em produção, ou estenda o teste gratuito se precisar de mais tempo de avaliação.