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

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

La instalación de IronQR a través del gestor de paquetes NuGet se realiza en cuestión de segundos. Abra la consola del Administrador de paquetes NuGet en Visual Studio y ejecute el siguiente comando, o utilice 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 lo convierte en una biblioteca versátil para cualquier proyecto de Visual Studio.

Antes de escribir cualquier código, necesita una clave de licencia de prueba gratuita . Configúrelo al inicio de su aplicación para que todas las llamadas posteriores estén autenticadas:

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";

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 generar tu primer código QR?

Para crear su primer código QR se requiere un código mínimo. La clase QrWriter maneja la generación de códigos QR con valores predeterminados razonables 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");

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

Los códigos QR admiten cuatro niveles de corrección de errores definidos en el estándar de código QR ISO/IEC 18004 que determinan cuánto daño puede sufrir un código sin dejar de ser escaneable. IronQR admite los cuatro niveles a través de la clase QrOptions:

using IronQr;
using IronSoftware.Drawing;

// Configure high error correction level
var options = new QrOptions(QrErrorCorrectionNivel.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(QrErrorCorrectionNivel.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");

¿Cómo personalizar la apariencia del código QR?

IronQR ofrece amplias opciones de estilo a través de QrStyleOptions, lo que permite colores, dimensiones, márgenes e incrustación de logotipos personalizados. 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");

¿Cómo guardar 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 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();

¿Cómo se compara el paquete NuGet IronQR con QRCoder?

La biblioteca QRCoder es una opción popular de código abierto 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 involucra QRCodeGenerator, QRCodeData y una clase de representación separada como PngByteQRCode. IronQR simplifica esto a una única llamada QrWriter.Write().

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

Para los equipos que migran de QRCoder, consulte la guía de migración de QRCoder a IronQR para obtener un mapeo de API en paralelo.

¿Cómo se codifican 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 es útil para tokens cifrados, objetos serializados o identificadores binarios sin procesar que no se pueden representar 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");

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

IronQR gestiona tanto la escritura como la lectura. La clase QrReader acepta archivos de imágenes, 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}");
}

El motor de lectura impulsado por ML procesa imágenes en cualquier orientación y maneja daños parciales hasta el umbral de corrección de errores. Para escenarios de lectura de producción, revise el tutorial de lectura de códigos QR para obtener orientación sobre el manejo de entradas de baja calidad, imágenes de múltiples códigos y configuración del modo de escaneo.

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

Las aplicaciones web con frecuencia necesitan generar códigos QR a pedido: para enlaces a cuentas de usuario, códigos de inicio de sesión único 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 ASP.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();

Este patrón funciona tanto en las API mínimas de ASP.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 sobre la integración de ASP.NET Core , consulte el tutorial del generador de código QR de ASP.NET Core . También está disponible una guía específica de Blazor en el tutorial del generador de códigos QR de Blazor .

¿Cómo agregar un margen y cambiar el tamaño de una imagen de código QR?

El control de las dimensiones y las zonas tranquilas es esencial para obtener resultados de calidad de impresión. IronQR expone ambos a través de QrStyleOptions, y existen guías prácticas dedicadas que cubren cada uno 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");

Para obtener orientación completa sobre los requisitos de tamaño y márgenes en diferentes medios de salida, consulte los artículos instructivos sobre cómo cambiar el tamaño de las imágenes de códigos QR y cómo agregar márgenes a los códigos QR . La guía de creación de 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 salida del archivo.

Para casos de uso de códigos QR específicos (incluida la generación de códigos QR para tarjetas de presentación , la creación de un generador de códigos QR dinámico y la lectura de códigos QR a partir de imágenes ), los artículos dedicados cubren 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 NuGet . Instala el paquete, llama a QrWriter.Write() y 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 estampado de PDF y la lectura impulsada por ML están disponibles a través de la misma biblioteca.

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

Comience una prueba gratuita para explorar el conjunto completo de funciones sin restricciones o compre una licencia para implementación de producción con soporte de ingeniería las 24 horas, los 5 días de la semana.