Cómo generar códigos QR en C# con un paquete NuGet

¿Cómo se instala un paquete NuGet de QR Code?

La instalación de IronQR a través del gestor de paquetes NuGet se realiza en cuestión de segundos. Abre la consola del Administrador de paquetes de NuGet en Visual Studio y ejecuta el siguiente comando, o utiliza el comando dotnet add package para entornos CLI:

Install-Package IronQR

El paquete NuGet gestiona automáticamente todas las dependencias, garantizando la compatibilidad con los marcos de trabajo de destino. IronQR es compatible con .NET Framework 4.6.2+, .NET Core 2.0+ y .NET 5-10, lo que la convierte en una biblioteca versátil para cualquier proyecto de Visual Studio.

Antes de escribir cualquier código, necesitas una clave de licencia de prueba gratuita. Configúralo al inicio de tu aplicación para que todas las llamadas posteriores se autentiquen:

using IronQr;

// Set license key before any IronQR operation
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

using IronQr;

// Set license key before any IronQR operation
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

Imports IronQr

' Set license key before any IronQR operation
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"

Con la clave de licencia instalada, su aplicación está lista para generar, leer y personalizar códigos QR sin marcas de agua en las imágenes de salida.

¿Cómo se genera el primer código QR?

Crear tu primer código QR requiere muy poco código. La clase QrWriter gestiona la generación de códigos QR con valores predeterminados sensatos que funcionan bien para la mayoría de los casos de uso:

using IronQr;
using IronSoftware.Drawing;

// Generate a QR code from text data
QrCode myQr = QrWriter.Write("Hello World");

// Save QR code as bitmap image
AnyBitmap qrImage = myQr.Save();

// Export to PNG file
qrImage.SaveAs("hello-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Generate a QR code from text data
QrCode myQr = QrWriter.Write("Hello World");

// Save QR code as bitmap image
AnyBitmap qrImage = myQr.Save();

// Export to PNG file
qrImage.SaveAs("hello-qr.png");

Imports IronQr
Imports IronSoftware.Drawing

' Generate a QR code from text data
Dim myQr As QrCode = QrWriter.Write("Hello World")

' Save QR code as bitmap image
Dim qrImage As AnyBitmap = myQr.Save()

' Export to PNG file
qrImage.SaveAs("hello-qr.png")

¿Cómo elegir el nivel adecuado de corrección de errores?

Los códigos QR admiten cuatro niveles de corrección de errores definidos en la norma ISO/IEC 18004 sobre códigos QR, que determinan el grado de daño que puede sufrir un código sin dejar de ser escaneable. IronQR es compatible con los cuatro niveles a través de la clase QrOptions:

using IronQr;
using IronSoftware.Drawing;

// Configure high error correction level
var options = new QrOptions(QrErrorCorrectionLevel.High);

// Generate QR code with options
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap image = qr.Save();
image.SaveAs("high-correction-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Configure high error correction level
var options = new QrOptions(QrErrorCorrectionLevel.High);

// Generate QR code with options
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap image = qr.Save();
image.SaveAs("high-correction-qr.png");

Imports IronQr
Imports IronSoftware.Drawing

' Configure high error correction level
Dim options As New QrOptions(QrErrorCorrectionLevel.High)

' Generate QR code with options
Dim qr As QrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options)
Dim image As AnyBitmap = qr.Save()
image.SaveAs("high-correction-qr.png")

¿Cómo se personaliza el aspecto de los códigos QR?

IronQR ofrece amplias opciones de estilo a través de QrStyleOptions, lo que permite personalizar colores, dimensiones, márgenes e incrustar logotipos. Los códigos QR de marca funcionan mejor en contextos de marketing porque asocian visualmente el código con una identidad conocida:

using IronQr;
using IronSoftware.Drawing;

// Create styled QR code with custom colors
var styleOptions = new QrStyleOptions
{
    Dimensions = 300,    // Width and height in pixels
    Margins = 10,        // Quiet zone in pixels
    Color = Color.DarkBlue,
    BackgroundColor = Color.White
};

QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap styledImage = qr.Save(styleOptions);
styledImage.SaveAs("styled-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Create styled QR code with custom colors
var styleOptions = new QrStyleOptions
{
    Dimensions = 300,    // Width and height in pixels
    Margins = 10,        // Quiet zone in pixels
    Color = Color.DarkBlue,
    BackgroundColor = Color.White
};

QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap styledImage = qr.Save(styleOptions);
styledImage.SaveAs("styled-qr.png");

Imports IronQr
Imports IronSoftware.Drawing

' Create styled QR code with custom colors
Dim styleOptions As New QrStyleOptions With {
    .Dimensions = 300,    ' Width and height in pixels
    .Margins = 10,        ' Quiet zone in pixels
    .Color = Color.DarkBlue,
    .BackgroundColor = Color.White
}

Dim qr As QrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/")
Dim styledImage As AnyBitmap = qr.Save(styleOptions)
styledImage.SaveAs("styled-qr.png")

¿Cómo se guardan los códigos QR en diferentes formatos de salida?

IronQR admite varios formatos de salida, como PNG, JPEG, GIF, TIFF, BMP y SVG. El método SaveAs detecta automáticamente el formato a partir de la extensión del archivo:

using IronQr;
using IronSoftware.Drawing;

QrCode qr = QrWriter.Write("Format demonstration");
AnyBitmap image = qr.Save();

// Save to raster image formats
image.SaveAs("qr-output.png");
image.SaveAs("qr-output.jpg");
image.SaveAs("qr-output.gif");

// Get as byte array for HTTP responses or database storage
byte[] pngBytes = image.ExportBytes();

using IronQr;
using IronSoftware.Drawing;

QrCode qr = QrWriter.Write("Format demonstration");
AnyBitmap image = qr.Save();

// Save to raster image formats
image.SaveAs("qr-output.png");
image.SaveAs("qr-output.jpg");
image.SaveAs("qr-output.gif");

// Get as byte array for HTTP responses or database storage
byte[] pngBytes = image.ExportBytes();

Imports IronQr
Imports IronSoftware.Drawing

Dim qr As QrCode = QrWriter.Write("Format demonstration")
Dim image As AnyBitmap = qr.Save()

' Save to raster image formats
image.SaveAs("qr-output.png")
image.SaveAs("qr-output.jpg")
image.SaveAs("qr-output.gif")

' Get as byte array for HTTP responses or database storage
Dim pngBytes As Byte() = image.ExportBytes()

¿En qué se diferencia el paquete NuGet de IronQR de QRCoder?

La biblioteca QRCoder es una opción de código abierto muy popular para la generación de códigos QR en .NET. Los desarrolladores que han utilizado QRCoder están familiarizados con su API de varios pasos que incluye QRCodeGenerator, QRCodeData y una clase de representación independiente como PngByteQRCode. IronQR simplifica esto a una sola llamada QrWriter.Write().

QRCoder funciona bien para la generación básica en entornos Windows. El modelo de aprendizaje automático de IronQR ofrece una lectura superior de códigos QR desde cualquier ángulo, algo fundamental para aplicaciones que procesan imágenes enviadas por los usuarios, en las que no se puede controlar la calidad de la entrada. La API de método único también reduce las líneas de código necesarias para implementar una función operativa.

Para los equipos que migran desde QRCoder, consulte la guía de migración de QRCoder a IronQR para ver una comparación detallada de las API.

¿Cómo se codifican los datos binarios en un código QR?

Más allá del texto, IronQR admite la codificación de matrices de bytes para cargas útiles de códigos QR binarios. Esto resulta útil para tokens cifrados, objetos serializados o identificadores binarios sin procesar que no pueden representarse como cadenas UTF-8:

using IronQr;
using IronSoftware.Drawing;

// Encode binary data -- useful for encrypted payloads or binary identifiers
byte[] binaryData = System.Text.Encoding.UTF8.GetBytes("Binary content example");
QrCode qr = QrWriter.Write(binaryData);
qr.Save().SaveAs("binary-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Encode binary data -- useful for encrypted payloads or binary identifiers
byte[] binaryData = System.Text.Encoding.UTF8.GetBytes("Binary content example");
QrCode qr = QrWriter.Write(binaryData);
qr.Save().SaveAs("binary-qr.png");

Imports IronQr
Imports IronSoftware.Drawing

' Encode binary data -- useful for encrypted payloads or binary identifiers
Dim binaryData As Byte() = System.Text.Encoding.UTF8.GetBytes("Binary content example")
Dim qr As QrCode = QrWriter.Write(binaryData)
qr.Save().SaveAs("binary-qr.png")

¿Cómo se leen los códigos QR en C#?

IronQR gestiona tanto la escritura como la lectura. La clase QrReader acepta archivos de imagen, mapas de bits y fotogramas de cámara, lo que la hace adecuada tanto para el procesamiento por lotes como para escenarios de escaneo en tiempo real:

using IronQr;
using IronSoftware.Drawing;

// Load an existing image containing a QR code
var inputImage = AnyBitmap.FromFile("qr-to-read.png");

// Read all QR codes in the image
QrReadResult readResult = QrReader.Read(inputImage);

foreach (QrResult result in readResult.QrCodes)
{
    // Access the decoded value
    Console.WriteLine($"Decoded: {result.Value}");
}

using IronQr;
using IronSoftware.Drawing;

// Load an existing image containing a QR code
var inputImage = AnyBitmap.FromFile("qr-to-read.png");

// Read all QR codes in the image
QrReadResult readResult = QrReader.Read(inputImage);

foreach (QrResult result in readResult.QrCodes)
{
    // Access the decoded value
    Console.WriteLine($"Decoded: {result.Value}");
}

Imports IronQr
Imports IronSoftware.Drawing

' Load an existing image containing a QR code
Dim inputImage = AnyBitmap.FromFile("qr-to-read.png")

' Read all QR codes in the image
Dim readResult As QrReadResult = QrReader.Read(inputImage)

For Each result As QrResult In readResult.QrCodes
    ' Access the decoded value
    Console.WriteLine($"Decoded: {result.Value}")
Next

El motor de lectura basado en aprendizaje automático procesa imágenes en cualquier orientación y gestiona daños parciales hasta el umbral de corrección de errores. Para escenarios de lectura en producción, consulte el tutorial de lectura de códigos QR para obtener orientación sobre cómo gestionar entradas de baja calidad, imágenes con varios códigos y la configuración del modo de escaneo.

¿Cómo se utiliza IronQR en una aplicación ASP.NET Core?

Las aplicaciones web suelen necesitar generar códigos QR bajo demanda, ya sea para enlaces a cuentas de usuario, códigos de inicio de sesión de un solo uso o solicitudes de pago. El siguiente ejemplo muestra cómo servir una imagen de código QR directamente desde un punto final de API mínima de .NET Core:

using IronQr;
using IronSoftware.Drawing;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// Set license key at application startup
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

// Return a QR code PNG for a given URL parameter
app.MapGet("/qr", (string data) =>
{
    QrCode qr = QrWriter.Write(data);
    AnyBitmap image = qr.Save();
    byte[] pngBytes = image.ExportBytes();
    return Results.File(pngBytes, "image/png");
});

app.Run();

using IronQr;
using IronSoftware.Drawing;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// Set license key at application startup
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

// Return a QR code PNG for a given URL parameter
app.MapGet("/qr", (string data) =>
{
    QrCode qr = QrWriter.Write(data);
    AnyBitmap image = qr.Save();
    byte[] pngBytes = image.ExportBytes();
    return Results.File(pngBytes, "image/png");
});

app.Run();

Imports IronQr
Imports IronSoftware.Drawing

Dim builder = WebApplication.CreateBuilder(args)
Dim app = builder.Build()

' Set license key at application startup
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"

' Return a QR code PNG for a given URL parameter
app.MapGet("/qr", Function(data As String)
                      Dim qr As QrCode = QrWriter.Write(data)
                      Dim image As AnyBitmap = qr.Save()
                      Dim pngBytes As Byte() = image.ExportBytes()
                      Return Results.File(pngBytes, "image/png")
                  End Function)

app.Run()

Este patrón funciona tanto en las API mínimas de .NET Core como en los controladores MVC estándar. La llamada ExportBytes() evita escribir archivos temporales en el disco, lo cual es importante en implementaciones en contenedores donde el sistema de archivos puede ser de solo lectura o efímero.

Para obtener una guía completa de integración con ASP.NET Core, consulte el tutorial del generador de códigos QR de .NET Core. También hay disponible una guía específica para Blazor en el tutorial del generador de códigos QR de Blazor.

¿Cómo se añade un margen y se cambia el tamaño de una imagen de código QR?

El control de las dimensiones y las zonas de seguridad es esencial para obtener una impresión de calidad. IronQR ofrece ambas a través de QrStyleOptions, y hay guías prácticas específicas que tratan cada una de ellas en detalle:

using IronQr;
using IronSoftware.Drawing;

// Specify dimensions and quiet zone for print output
var printOptions = new QrStyleOptions
{
    Dimensions = 600,   // High resolution for print
    Margins = 20        // Generous quiet zone for reliable scanning
};

QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap printImage = qr.Save(printOptions);
printImage.SaveAs("print-ready-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Specify dimensions and quiet zone for print output
var printOptions = new QrStyleOptions
{
    Dimensions = 600,   // High resolution for print
    Margins = 20        // Generous quiet zone for reliable scanning
};

QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap printImage = qr.Save(printOptions);
printImage.SaveAs("print-ready-qr.png");

Imports IronQr
Imports IronSoftware.Drawing

' Specify dimensions and quiet zone for print output
Dim printOptions As New QrStyleOptions With {
    .Dimensions = 600,   ' High resolution for print
    .Margins = 20        ' Generous quiet zone for reliable scanning
}

Dim qr As QrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/")
Dim printImage As AnyBitmap = qr.Save(printOptions)
printImage.SaveAs("print-ready-qr.png")

Para obtener orientación completa sobre los requisitos de tamaño y márgenes en los diferentes soportes de salida, consulte los artículos prácticos sobre cómo cambiar el tamaño de las imágenes de códigos QR y añadir márgenes a los códigos QR. La guía para crear imágenes de códigos QR cubre todo el flujo de trabajo de creación de imágenes, desde la activación de la licencia hasta la generación del archivo.

Para casos de uso específicos de códigos QR —incluida la generación de códigos QR para tarjetas de visita, la creación de un generador dinámico de códigos QR y la lectura de códigos QR a partir de imágenes—, los artículos dedicados abordan cada escenario con ejemplos de código completos.

¿Cuales son tus próximos pasos?

IronQR convierte la generación de códigos QR de un proceso de varios pasos en una sencilla integración de NuGet. Se instala el paquete, se llama a QrWriter.Write() y se guarda el resultado: tres operaciones que cubren la mayoría de los escenarios del mundo real. Los niveles de corrección de errores, el estilo personalizado, el sellado de PDF y la lectura basada en aprendizaje automático están disponibles a través de la misma biblioteca.

La documentación de IronQR proporciona la referencia completa de la API, incluyendo temas avanzados como la lectura de códigos QR con modos de escaneo, el procesamiento por lotes y notas de implementación específicas para cada plataforma. La sección de tutoriales de IronQR incluye guías paso a paso for .NET MAUI, VB.NET y aplicaciones de consola.

Inicie una prueba gratuita para explorar todas las funciones sin restricciones, o adquiera una licencia para la implementación en producción con asistencia técnica 24/5.