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 fotogramas de vídeo en directo, corrección de la rotación, el ruido, la distorsión y la inclinación.
• IronBarcode puede ser utilizados en varios 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 admite arquitecturas de 32 y 64 bits y puede utilizarse en ambas implementaciones de .NET (.NET Core y .NET Framework).
• IronBarcode soporta Consola, Escritorio, Nube y aplicaciones web en PC y plataformas móviles.
• IronBarcode puede generar imágenes de códigos QR para una amplia gama de archivos y formatos de flujo, incluidos 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

Abra Visual Studio y seleccione Nuevo proyecto en el menú Archivo.

Elija la plantilla Console App en la ventana que aparece y haga clic en Siguiente.

Creación de 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 el nombre del proyecto que desee. (por ejemplo, QR Code Generator.)y especifique una ubicación para el nuevo proyecto en el campo Ubicación. A continuación, 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.

Elija un .NET Framework en el menú desplegable Framework (aquí, estamos usando .NET 6.0 (Ayuda a largo plazo)*) y haga clic en Crear.

Creación de la nueva aplicación de consola en Visual Studio con .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

En la barra de menús, 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 mediante la interfaz de usuario del gestor de paquetes NuGet de Visual Studio.

Como alternativa, puede hacer clic con el botón derecho del ratón en el nombre del proyecto en la ventana del Explorador de soluciones y seleccionar Administrar paquetes NuGet... en el menú contextual.

Haga clic en la pestaña Buscar y escriba Código de barras en el campo de búsqueda. Seleccione IronBarcode de la lista de paquetes relacionados (que se muestra como primer resultado en la siguiente imagen)seleccione su proyecto en el panel de la derecha y haga clic en el botón Instalar.

Búsqueda de la biblioteca IronBarcode en la interfaz de usuario del gestor de paquetes. Lo más probable es que aparezca antes que las demás bibliotecas en los resultados de la 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 Galería NuGet en su navegador, (o haga clic en Enlace al paquete NuGet `BarCode para acceder directamente a la página).

Haga clic en el enlace Descargar paquete del menú de la derecha para guardar la biblioteca en su ordenador. 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 Página de IronBarcode para descargar la última 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 con el botón derecho en el proyecto desde el panel del Explorador de Soluciones, y haga clic en Añadir > Referencia COM.

   

   Añadir la DLL IronBarcode al proyecto directamente 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 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 la función CrearQrCode del método QRCodeWriter clase:

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 son los datos a codificar en la imagen del código (puede ser String o Stream.). El método también acepta tres parámetros opcionales:

1. La anchura 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áximo. Por defecto, CreateQrCode utiliza el nivel de corrección más alto 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 por defecto) indica al método que utilice el número de versión correcto en función de los datos que va a 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 posterior al Guardar como Png 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

   A continuación, el código de ejemplo que figura a continuación utiliza la función CrearQrCodeConLogotipo para añadir el logotipo de una empresa a un código QR generado, un caso de uso típico para cualquier empresa.

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 String de "Hola, mundo" se codifica en un nuevo código QR que incrusta una imagen situada 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 utiliza CambiarCódigoColorBarra para cambiar el color del código QR a rojo oscuro. En este caso, realizamos la coloración utilizando uno de los tipos de clase de color disponibles en el sistema 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 archivo 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 legal y sobre licencias para utilizar IronBarcode puede consultarse en la página web página de licencias. IronBarcode es de uso gratuito bajo la licencia Free Developer License. La prima (pagado) La licencia para desarrolladores incluye un año de asistencia gratuita y actualizaciones del producto.