Generador de códigos QR .NET (Tutorial de ejemplo de código)

Este tutorial utilizará IronBarcode como librería principal para generar códigos QR que tienen muchas aplicaciones en diferentes industrias.

Presentación de IronBarcode

Características adicionales

• IronBarcode puede leer y escribir la mayoría de los tipos de códigos de barras y estándares QR, como UPC A/E, EAN 8/13, Code 39/93/128, ITF, MSI, RSS 14/Expanded, Databar y CodaB.
• IronBarcode preprocesa automáticamente las imágenes de los códigos de barras para mejorar la eficacia y la precisión de la lectura.
• IronBarcode puede leer escaneos y marcos de video en vivo, corrigiendo rotación, ruido, distorsión e inclinación.
• IronBarcode se puede utilizar a través de múltiples núcleos e hilos (muy útil para aplicaciones de servidor que realizan procesamiento por lotes).
• IronBarcode puede encontrar automáticamente uno o varios códigos de barras en documentos de una o varias páginas.
• IronBarcode es compatible con arquitecturas de 32 y 64 bits y se puede utilizar en implementaciones de .NET (.NET Core y .NET Framework).
• IronBarcode admite aplicaciones de consola, escritorio, nube y web en plataformas de PC y móviles.
• IronBarcode puede generar imágenes de códigos QR para una variedad de archivos y formatos de transmisión, incluyendo PDF, JPG, TIFF, GIF, BMP, PNG y HTML.

Generación de códigos QR con IronBarcode

Las secciones siguientes de este artículo presentan un ejemplo para demostrar cómo generar códigos QR fácilmente.

Paso 1. Crear un nuevo proyecto Crear un nuevo proyecto

Abre Visual Studio y selecciona Nuevo Proyecto en el menú Archivo.

Elija la plantilla de Aplicación de Consola en la ventana que aparece y haga clic en Siguiente.

Creando una nueva aplicación de consola en Visual Studio para la generación de códigos QR

En el campo de texto Nombre del proyecto, escriba cualquier nombre de proyecto que desee (por ejemplo, Generador de Códigos QR), y especifique una ubicación para el nuevo proyecto en el campo Ubicación. Después, haga clic en el botón Siguiente para continuar.

Elegir un nombre y una ubicación para una nueva aplicación de consola en Visual Studio para crear códigos QR

Elige un .NET Framework del menú desplegable Framework (aquí, estamos usando .NET 6.0 (Soporte a largo plazo)) y haz clic en Crear.

Creación de la nueva aplicación de consola en Visual Studio bajo .NET 6.0 Framework

Paso 2. Instale la biblioteca de códigos de barras

2.1 Utilización de IronBarcode

Puede descargar e instalar la biblioteca IronBarcode de cuatro formas.

Estas formas son:

• Uso de la interfaz de usuario del gestor de paquetes NuGet de Visual Studio,
• Uso de la consola del gestor de paquetes de Visual Studio,
• Descargándolo directamente del sitio web de NuGet, o bien
• Descargándolo directamente de la web de IronBarcode.

2.1.1 Uso de la interfaz de usuario del gestor de paquetes de Visual Studio

Desde la barra de menú, vaya a Herramientas > Administrador de paquetes NuGet > Administrar paquetes NuGet para la solución... para abrir la interfaz de usuario del Administrador de paquetes.

Instalación de la biblioteca IronBarcode utilizando la interfaz de usuario del Administrador de paquetes NuGet de Visual Studio

Alternativamente, puede hacer clic con el botón derecho en el nombre de su proyecto desde la ventana del Explorador de Soluciones y seleccionar Administrar paquetes de NuGet... en el menú contextual.

Haga clic en la pestaña Explorar y escriba Barcode en el campo de búsqueda. Seleccione IronBarcode de la lista de paquetes relacionados (mostrada como el primer resultado en la imagen a continuación), elija su proyecto en el panel de la derecha y haga clic en el botón Instalar.

Buscando la biblioteca IronBarcode en la interfaz de usuario del administrador de paquetes. Lo más probable es que aparezca antes que todas las demás bibliotecas en los resultados de búsqueda

2.1.2 Uso de la consola del gestor de paquetes de Visual Studio

Vaya a Herramientas > Administrador de paquetes NuGet > Consola del administrador de paquetes. Introduzca el siguiente comando en el panel de línea de comandos que aparece y pulse ENTER:

Install-Package BarCode

El comando anterior descargará e instalará la biblioteca en el proyecto actual.

2.1.3 Descargar la biblioteca desde el sitio web de NuGet

Busque la página de la biblioteca de códigos de barras en el sitio web de la Galería de NuGet en su navegador, (o haga clic en este enlace del paquete de NuGet BarCode para acceder a la página directamente).

Haz clic en el enlace Descargar paquete del menú en el lado derecho para guardar la biblioteca en tu computadora. A continuación, haga doble clic en la biblioteca descargada desde el Administrador de archivos para instalarla automáticamente en el proyecto. Por último, vuelve a cargar el proyecto y estará listo para funcionar.

2.1.4 Descarga de la librería desde la web de IronBarcode

Haga clic en la página principal de IronBarcode para descargar el último DLL de código de barras .NET. Una vez descargado, siga los pasos que se indican a continuación para añadir el paquete a su proyecto:

1. Haga clic derecho en el proyecto desde el Panel del Explorador de soluciones y haga clic en Agregar > Referencia COM.

   

   Agregar la DLL de IronBarcode directamente al proyecto desde Visual Studio

2. Haga clic en el botón Examinar y navegue hasta la ubicación donde ha extraído la DLL. Con la DLL seleccionada, haz clic en OK para añadirla a tu proyecto.

   

   Insertar la DLL de IronBarcode como una nueva referencia COM en su proyecto

Paso 3. Generar un código QR Generar una imagen de código QR

3.1 Utilización de IronBarcode en una aplicación Windows/Consola

Genere un nuevo código QR invocando el método CreateQrCode de la clase QRCodeWriter:

QRCodeWriter.CreateQrCode("hello world", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium, 0).SaveAsPng("MyQR.png");

QRCodeWriter.CreateQrCode("hello world", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium, 0).SaveAsPng("MyQR.png");

QRCodeWriter.CreateQrCode("hello world", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium, 0).SaveAsPng("MyQR.png")

El método CreateQrCode acepta un parámetro obligatorio, que es el dato que se codificará en la imagen del código (puede ser un String o un Stream). El método también acepta tres parámetros opcionales:

1. El ancho y la altura del gráfico (500px por 500px por defecto)

2. Un nivel de corrección de errores. IronBarcode ofrece cuatro niveles de corrección de errores: Bajo, Medio, Alto y Más Alto. Por defecto, CreateQrCode utiliza el nivel más alto de corrección QRCodeWriter.QrErrorCorrectionLevel.Highest

3. Un número de versión del símbolo QR. Consulte esta página para una lista de versiones válidas. Un valor de 0 (el valor predeterminado) indica al método que utilice el número de versión correcto basado en los datos que codificará.

   El ejemplo anterior genera un gráfico de 500 píxeles por 500 píxeles utilizando el nivel medio de corrección de errores. La llamada subsiguiente al método SaveAsPng en el código QR generado lo guarda como un archivo PNG en una ubicación de archivo determinada.

   

   El resultado de llamar a QrCodeWriter.CreateQrCode utilizando los parámetros mencionados anteriormente

   A continuación, el siguiente código de ejemplo utiliza el método CreateQrCodeWithLogo para añadir un logotipo de empresa a un código QR generado, un caso de uso típico para cualquier negocio.

var qrWithLogo = QRCodeWriter.CreateQrCodeWithLogo("Hello World", "qrlogo.png",500);
qrWithLogo.ChangeBarCodeColor(System.Drawing.Color.DarkRed);
qrWithLogo.SaveAsPng("Logo_QR_Code.png");

var qrWithLogo = QRCodeWriter.CreateQrCodeWithLogo("Hello World", "qrlogo.png",500);
qrWithLogo.ChangeBarCodeColor(System.Drawing.Color.DarkRed);
qrWithLogo.SaveAsPng("Logo_QR_Code.png");

Dim qrWithLogo = QRCodeWriter.CreateQrCodeWithLogo("Hello World", "qrlogo.png",500)
qrWithLogo.ChangeBarCodeColor(System.Drawing.Color.DarkRed)
qrWithLogo.SaveAsPng("Logo_QR_Code.png")

En el ejemplo anterior, un valor de String de "Hello, World" se codifica en un nuevo código QR que incrusta una imagen ubicada en una ruta de archivo especificada. El tamaño de la imagen se ajusta automáticamente a la cuadrícula del código QR, alineándose con el tamaño que permitirá a los lectores de códigos QR seguir leyendo los datos puros del código.

La siguiente línea de código anterior utiliza el método ChangeBarCodeColor para cambiar el color del código QR a rojo oscuro. Aquí, hacemos la coloración utilizando uno de los tipos de clase de color del sistema disponibles proporcionados por C# (a saber, System.Drawing.Color.DarkRed). Es posible especificar colores en la notación de color hexadecimal de HTML, como muestra la línea de código siguiente:

qrWithLogo.ChangeBarCodeColor(System.Drawing.ColorTranslator.FromHtml("#8B0000"));

qrWithLogo.ChangeBarCodeColor(System.Drawing.ColorTranslator.FromHtml("#8B0000"));

qrWithLogo.ChangeBarCodeColor(System.Drawing.ColorTranslator.FromHtml("#8B0000"))

La última línea de código del ejemplo anterior llama al método SaveAsPng para guardar el código QR como un archivo PNG. Los códigos QR pueden guardarse en otros formatos de archivo, como HTML:

qrWithLogo.SaveAsHtmlFile("test.html");

qrWithLogo.SaveAsHtmlFile("test.html");

qrWithLogo.SaveAsHtmlFile("test.html")

Consulte esta página de documentación para obtener una lista completa de los tipos de archivos en los que se pueden guardar los códigos QR.

Genere códigos QR en diferentes colores, en diferentes formatos de archivo y utilizando diferentes imágenes con los métodos disponibles en la clase QRCodeWriter de IronBarcode

3.2 Utilización de IronBarcode en una aplicación Web

La línea de código demuestra cómo se puede utilizar IronBarcode dentro de una Aplicación Web .NET MVC:

public IActionResult Index()
{
    QRCodeWriter.CreateQrCode("hello world", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium, 0).SaveAsPdf("Demo.png");
    return File("Demo.png", "image/png", "Demo.png", true);
}

public IActionResult Index()
{
    QRCodeWriter.CreateQrCode("hello world", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium, 0).SaveAsPdf("Demo.png");
    return File("Demo.png", "image/png", "Demo.png", true);
}

Public Function Index() As IActionResult
	QRCodeWriter.CreateQrCode("hello world", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium, 0).SaveAsPdf("Demo.png")
	Return File("Demo.png", "image/png", "Demo.png", True)
End Function

El ejemplo anterior funciona de forma muy similar a los ejemplos anteriores. En primer lugar, se genera un código QR y, a continuación, se devuelve al cliente en el cuerpo de la respuesta.

Conclusión

IronBarcode es una de las bibliotecas más rápidas y potentes disponibles para leer y escribir códigos de barras. Esta sencilla biblioteca es compatible con varios sistemas operativos, admite muchos formatos de códigos de barras y es fácil de usar.

La información de licencias y legal para usar IronBarcode se puede encontrar en la página de licencias. IronBarcode es de uso gratuito bajo la licencia Free Developer License. La licencia de desarrollador premium (de pago) incluye un año de soporte gratuito y actualizaciones del producto.