Cómo leer valores de códigos QR en C

¿Cómo leo el valor de un código QR desde una imagen?

Para extraer el valor incrustado en un código QR, carga la imagen en un QrImageInput, pásala a QrReader.Read() y accede a la propiedad Value en el QrResult devuelto. El método devuelve una colección, un resultado por cada código QR encontrado en la imagen.

Entrada

El código QR a continuación codifica https://ironsoftware.com y será escaneado para extraer su 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

La propiedad Value devuelve la cadena decodificada en bruto tal como fue codificada: una URL, un número, texto libre, u otros datos. El método Read() siempre devuelve un IEnumerable<QrResult>, incluso cuando solo hay un código QR presente. Si la imagen contiene múltiples códigos QR, itera con foreach (var result in results) para procesar cada uno. Guarda con results.Any() antes de llamar a .First() para manejar imágenes donde no se encuentra ningún código QR.

Resultado

---

¿Cómo leo todas las propiedades de un código QR?

Cada QrResult expone tres propiedades que juntas dan una visión completa de lo que fue escaneado y donde se encontró en la imagen. Usando el mismo código QR de entrada de arriba:

: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

Resultado

---

¿Qué propiedades expone QrResult?

QrResult expone las siguientes propiedades después de un escaneo exitoso:

¿Cuáles son los casos de uso comunes para la lectura de valores de códigos QR?

• Terminales de pago: Decodifica una URL de transacción o ID de referencia de un código QR de cliente para iniciar un flujo de pago.
• Validación de boletos: Extrae una referencia de reserva de un código QR impreso o en pantalla para verificar la entrada al evento.
• Gestión de inventario: Lee números de serie de producto o SKUs de etiquetas de almacén para actualizar registros de stock.
• Verificación de documentos: Extrae un ID de registro o un hash de un código QR estampado en un documento legal o gubernamental.
• Autenticación de usuarios: Decodifica un token de un solo uso de un código QR para completar un paso de inicio de sesión de dos factores.

Para más patrones de lectura de códigos QR, explora la guía Leer Códigos QR desde Imagen y el conjunto completo de características de IronQR.