Como Ler Valores de Código QR em C#

Como faço para ler um valor de código QR de uma imagem?

Para extrair o valor embutido em um código QR, carregue a imagem em um QrImageInput, passe para QrReader.Read() e acesse a propriedade Value no QrResult retornado. O método retorna uma coleção, um resultado por cada código QR encontrado na imagem.

Entrada

O código QR abaixo codifica https://ironsoftware.com e será escaneado para extrair seu valor.

:path=/static-assets/qr/content-code-examples/how-to/read-qr-code-value.cs

using IronQr;
using System.Drawing;

// Import image
var inputImage = Image.FromFile("sample.jpg");

// Load the asset into QrImageInput
QrImageInput imageInput = new QrImageInput(inputImage);

// Create a QR Reader object
QrReader reader = new QrReader();

// Read the input and get all embedded QR codes
IEnumerable<QrResult> results = reader.Read(imageInput);

// Display the value of the first QR code found
Console.WriteLine($"QR code value is {results.First().Value}");

$vbLabelText   $csharpLabel

A propriedade Value retorna a string decodificada bruta exatamente como foi codificada: uma URL, um número, texto livre ou qualquer outro dado. O método Read() sempre retorna um IEnumerable<QrResult>, mesmo quando apenas um código QR está presente. Se a imagem contiver múltiplos códigos QR, itere com foreach (var result in results) para processar cada um. Proteja com results.Any() antes de chamar .First() para lidar com imagens onde nenhum código QR é encontrado.

Saída

---

Como faço para ler todas as propriedades do código QR?

Cada QrResult expõe três propriedades que juntas fornecem o quadro completo do que foi escaneado e onde foi encontrado na imagem. Usando o mesmo código QR de entrada de cima:

:path=/static-assets/qr/content-code-examples/how-to/read-qr-code-value-properties.cs

using IronQr;
using IronSoftware.Drawing;

AnyBitmap inputImage = AnyBitmap.FromFile("sample.jpg");

QrImageInput imageInput = new QrImageInput(inputImage);
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);

QrResult result = results.First();

// Decoded text content of the QR code
Console.WriteLine($"Value: {result.Value}");

// Parsed URL — populated when Value is a valid URL, null otherwise
Console.WriteLine($"Url:   {result.Url}");

// Corner coordinates of the QR code in the image [TL, TR, BL, BR]
string[] labels = { "Top-Left", "Top-Right", "Bottom-Left", "Bottom-Right" };
for (int i = 0; i < result.Points.Length; i++)
{
    Console.WriteLine($"{labels[i]}: ({result.Points[i].X}, {result.Points[i].Y})");
}

Saída

---

Quais propriedades o QrResult expõe?

QrResult expõe as seguintes propriedades após um escaneamento bem-sucedido:

Quais são os casos de uso comuns para leitura de valor de QR Code?

• Terminais de pagamento: Decodifique uma URL de transação ou ID de referência do QR code de um cliente para iniciar um fluxo de pagamento.
• Validação de bilhetes: Extraia uma referência de reserva de um QR code impresso ou na tela para verificar a entrada em eventos.
• Gerenciamento de inventário: Leia números de série de produtos ou SKUs a partir de etiquetas de armazém para atualizar registros de estoque.
• Verificação de documentos: Obtenha um ID de registro ou hash de um QR code carimbado em um documento legal ou governamental.
• Autenticação de usuários: Decode um token de uso único de um QR code para completar uma etapa de login com dois fatores.

Para mais padrões de leitura de QR codes, explore o guia Ler QR Codes de Imagem e o conjunto completo de funcionalidades do IronQR.