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 incorporado em um código QR, carregue a imagem em um QrImageInput, passe-a 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}");

Imports IronQr
Imports System.Drawing
Imports System.Linq

' Import image
Dim inputImage As Image = Image.FromFile("sample.jpg")

' Load the asset into QrImageInput
Dim imageInput As New QrImageInput(inputImage)

' Create a QR Reader object
Dim reader As New QrReader()

' Read the input and get all embedded QR codes
Dim results As IEnumerable(Of QrResult) = 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 quaisquer outros dados. O método Read() sempre retorna um IEnumerable<QrResult>, mesmo quando apenas um código QR está presente. Se a imagem contiver vários códigos QR, itere com foreach (var result in results) para processar cada um deles. 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 a imagem completa do que foi digitalizado 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})");
}

Imports IronQr
Imports IronSoftware.Drawing

Dim inputImage As AnyBitmap = AnyBitmap.FromFile("sample.jpg")

Dim imageInput As New QrImageInput(inputImage)
Dim reader As New QrReader()
Dim results As IEnumerable(Of QrResult) = reader.Read(imageInput)

Dim result As QrResult = results.First()

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

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

' Corner coordinates of the QR code in the image [TL, TR, BL, BR]
Dim labels As String() = {"Top-Left", "Top-Right", "Bottom-Left", "Bottom-Right"}
For i As Integer = 0 To result.Points.Length - 1
    Console.WriteLine($"{labels(i)}: ({result.Points(i).X}, {result.Points(i).Y})")
Next i

Saída

---

Quais propriedades QrResult expõe?

QrResult expõe as seguintes propriedades após uma verificação bem-sucedida:

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.