1. IronBarcode
  2. Guías
  3. .NET Crear códigos de barras como imágenes
Cómo Crear Imágenes de Código de Barras y Código QR en C#

Cómo crear imágenes de códigos de barras en C# con IronBarcode

Hairil Hasyimi Bin Omar
Hairil Hasyimi Bin Omar
Actualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

como-título:2(Inicio Rápido: Crea y Guarda un Código de Barras Code128 en Una Línea)

Utiliza la API de una sola línea de IronBarcode para crear un código de barras Code128 a partir de una cadena y guardarlo como una imagen PNG. Los desarrolladores pueden comenzar de inmediato—sin complicaciones, sin plantillas—simplemente proporciona los datos, elige la codificación y el tamaño, y escribe tu archivo de imagen.

Nuget IconEmpieza a crear PDF con NuGet ahora:

  1. Instalar IronBarcode con el gestor de paquetes NuGet

    PM > Install-Package BarCode

  2. Copie y ejecute este fragmento de código.

    IronBarCode.BarcodeWriter.CreateBarcode("Sample123", BarcodeEncoding.Code128, 250, 100).SaveAsPng("Barcode.png");

  3. Despliegue para probar en su entorno real

    Empieza a utilizar IronBarcode en tu proyecto hoy mismo con una prueba gratuita
    arrow pointer

Flujo de trabajo mínimo (5 pasos)

  1. Descargar la biblioteca IronBarcode de C#
  2. Generar códigos de barras y guardarlos como archivos de imagen
  3. Generar códigos QR y guardarlos como archivos de imagen

Generar códigos de barras y guardarlos como archivos de imagen

Además de leer códigos de barras, IronBarcode es una herramienta poderosa que también permite a los usuarios escribir códigos de barras con muy poca programación. Para lograr esto, simplemente llama al método CreateBarcode() de la clase BarcodeWriter, donde se pueden especificar valor, tipo, ancho y alto del código de barras en los parámetros del método. Esto produce un objeto GeneratedBarcode, que luego se puede guardar como un archivo de imagen utilizando el método SaveAs(). Vamos a discutir cada parámetro en detalle y luego ver cómo implementar la escritura de código de barras con un fragmento de código.

Valor del código de barras

El método BarcodeWriter.CreateBarcode() acepta varios tipos de datos para los valores del código de barras. Estos incluyen byte[] array, MemoryStream, y string. Las longitudes de la cadena y qué caracteres se aceptan varían según el tipo de código de barras, pero todo esto está detallado en nuestra documentación.

Tipos de codificación de códigos de barras

IronBarcode admite una amplia variedad de formatos de código de barras para escribir—la lista completa se puede encontrar en nuestro artículo de Formatos de Códigos de Barras Soportados. Estos tipos de códigos de barras tienen sus propias propiedades únicas, especialidades, y usos—puedes investigar cuál es el más adecuado para tu caso de uso con nuestra documentación.

Ancho y alto

Establece el ancho y alto de la imagen del código de barras de salida en píxeles. Por defecto, ambas medidas están establecidas en 250 px. Varios tipos de códigos de barras, como QR y PDF417, requieren tener ciertas dimensiones para cumplir con las normativas, por lo que para anchos y altos de entrada que no coincidan con las dimensiones requeridas por el código de barras, el código se generará con las dimensiones cumplidoras y el espacio en blanco llenará el espacio restante. Si las dimensiones son demasiado pequeñas para el código de barras, se lanzará una excepción.

Importar códigos de barras como imagen

Al crear un código de barras con el método BarcodeWriter.CreateBarcode(), se generará un objeto GeneratedBarcode. Con este objeto, podemos guardar el código de barras en una variedad de tipos de imagen con varios métodos SaveAs() específicos para cada formato de imagen. Estos métodos incluyen:

  • SaveAsGif(): Este método guarda el GeneratedBarcode como un archivo de imagen GIF y acepta la ruta del archivo de imagen como argumento de cadena.
  • SaveAsJpeg(): Este método guarda el GeneratedBarcode como un archivo de imagen JPEG y acepta la ruta del archivo de imagen como argumento de cadena.
  • SaveAsPng(): Este método guarda el GeneratedBarcode como un archivo de imagen PNG y acepta la ruta del archivo de imagen como argumento de cadena.
  • SaveAsTiff(): Este método guarda el GeneratedBarcode como un archivo de imagen TIFF y acepta la ruta del archivo de imagen como argumento de cadena.
  • SaveAsWindowsBitmap(): Este método guarda el GeneratedBarcode como un archivo de imagen BMP y acepta la ruta del archivo de imagen como argumento de cadena.
  • SaveAsImage(): Este es un método general para guardar el GeneratedBarcode como un archivo de imagen—los usuarios deben especificar la extensión de formato de archivo deseada al introducir la ruta del archivo.

Generar un código de barras y guardarlo como archivo de imagen

Ahora usaremos el BarcodeWriter.CreateBarcode() para demostrar la creación de un código de barras Code128, y guardarlo en disco como un archivo de imagen JPEG.

:path=/static-assets/barcode/content-code-examples/how-to/create-barcode-images-one-dimensional.cs
using IronBarCode;

BarcodeWriter.CreateBarcode("IronBarcode123", BarcodeEncoding.Code128, 200, 100).SaveAsJpeg("OneDBarcode.jpeg");
Imports IronBarCode

BarcodeWriter.CreateBarcode("IronBarcode123", BarcodeEncoding.Code128, 200, 100).SaveAsJpeg("OneDBarcode.jpeg")
$vbLabelText   $csharpLabel
Código de barras unidimensional a partir de un fragmento

Generar códigos QR y guardarlos como archivos de imagen

Uno de los códigos de barras más populares hoy en día, código QR, que también es uno de los códigos de barras clasificados como un código bidimensional, está totalmente soportado por IronBarcode. Debido a su versatilidad, atractivo estético y funciones altamente personalizables, los códigos QR han ganado gran popularidad entre los usuarios.

Diferente de la creación de códigos de barras unidimensionales y otros, la creación de códigos QR utilizará un método diferente de una clase diferente en IronBarcode debido a la complejidad de los códigos QR que requieren diferentes propiedades y argumentos para producir códigos QR de alta calidad según requieran los clientes. Para crear códigos QR en IronBarcode, los usuarios necesitarán llamar al método CreateQrCode() de la clase QRCodeWriter. QRCodeWriter.CreateQrCode() acepta 4 argumentos: el valor del código de barras como el primer argumento, tamaño del código QR de salida como segundo, campo enum QRCodeWriter.QrErrorCorrectionLevel como tercer argumento, y finalmente el QRVersion. Discutamos en detalle los argumentos para este método.

Valores del código QR

Similar al método BarcodeWriter.CreateBarcode(), QRCodeWriter.CreateQrCode() primero acepta un valor para el Código QR que puede ser numérico, alfabético o alfanumérico. Estos valores se pueden introducir en el método como tipo byte[] array, MemoryStream y System.String.

Tamaño del código QR

Los usuarios también pueden especificar el tamaño del código QR directamente en el método como tipo Int32. La unidad de medida para el tamaño del código QR utilizado en este método es en píxeles (px). El tamaño por defecto del código QR es de 500 px.

Nivel de corrección de errores QR

QRErrorCorrectionLevel es una propiedad miembro de la clase QRCodeWriter donde tiene 4 campos: Más Alto, Alto, Medio y Bajo. Básicamente, esta propiedad es el nivel de tolerancia a fallos de un código QR, donde un nivel de corrección mayor crea códigos QR más complejos que son menos propensos a errores de lectura, incluso si está dañado o parcialmente oscurecido. Ahora, discutamos en detalle cada uno de los campos de esta propiedad, así como observemos la diferencia en la apariencia del código QR producido.

Nivel de corrección de errores QR.Más alto

Los códigos QR generados con el nivel de corrección Más Alto tendrán la imagen de código QR más compleja, con un 30% de corrección de errores. El código QR producido también se puede estampar con un logotipo o gráficos de imagen en el código QR.

Código QR con el nivel de corrección más alto

Nivel de corrección de errores QR.Alto

Establecer el campo de propiedad a Alto resultará en la aplicación de un 25% de corrección de errores en la imagen del código QR. Será menos complejo que la imagen del código QR producida por QRErrorCorrectionLevel.Más Alto.

Código QR con alto nivel de corrección

Nivel de corrección de errores QR.Medio

Este campo aplica solo un 15% de corrección de errores en la imagen del código QR. Usando esta configuración, los usuarios podrán producir códigos QR más rápido; sin embargo, son más propensos a errores.

Código QR con nivel de corrección medio

Nivel de corrección de errores QR.Bajo

Esta es la configuración más baja para el nivel de corrección de errores, que aplica solo un 7% de corrección de errores en la imagen del código QR, resultando en el Código QR con menor complejidad.

Código QR con bajo nivel de corrección

Versión QR

La Versión del Código QR es la versión del símbolo de un código QR que va del 1 al 40. Una versión superior del código QR producirá un código QR más complejo, permitiendo a los usuarios almacenar más datos, y viceversa para una versión inferior del código QR. Por favor, ten en cuenta, sin embargo, que si la versión del código QR se establece demasiado baja, pueden ocurrir problemas cuando los usuarios intenten codificar más datos de los permitidos por la versión. Establecer la versión del código QR como 0 asignará automáticamente la versión de QR apropiada basada en el valor que se debe codificar. Please refer to this site for more information on QR version: QR Version

Crear una imagen de código QR

El fragmento de código a continuación demuestra cómo usar el método QRCodeWriter.CreateQrCode() en IronBarcode para escribir un código QR y guardarlo como un archivo de imagen en disco utilizando el método SaveAsJpeg().

:path=/static-assets/barcode/content-code-examples/how-to/create-barcode-images-qr.cs
using IronBarCode;

QRCodeWriter.CreateQrCode("IronBarcode1234", 250, QRCodeWriter.QrErrorCorrectionLevel.Medium, qrVersion: 0).SaveAsJpeg("QRMedium.jpeg");
Imports IronBarCode

QRCodeWriter.CreateQrCode("IronBarcode1234", 250, QRCodeWriter.QrErrorCorrectionLevel.Medium, qrVersion:= 0).SaveAsJpeg("QRMedium.jpeg")
$vbLabelText   $csharpLabel
Código QR con nivel de corrección medio

Del fragmento de código anterior, se utilizó un valor alfanumérico como el valor para ser codificado en el código QR, y utilizamos 250 píxeles como medida del código QR producido. También especificamos la corrección de errores del código QR producido para que sea media y dejamos que el programa decida qué versión de código QR es adecuada para nuestro valor de código QR. Aparte de eso, también usamos SaveAsJpeg() que acepta el nombre del archivo de imagen del código QR con la extensión de formato de imagen, que es un JPEG en este caso, para ser guardado como argumento.

Preguntas Frecuentes

¿Cómo creo una imagen de código de barras en .NET?

Para crear una imagen de código de barras en .NET, utiliza la biblioteca IronBarcode. Primero, descárgala de NuGet, luego utiliza el método BarcodeWriter.CreateBarcode(), especificando el valor, tipo, ancho y alto del código de barras. Guarda la imagen resultante del código de barras usando métodos como SaveAsPng() o SaveAsJpeg().

¿Qué formatos de código de barras son compatibles en .NET?

La biblioteca .NET Barcode Library admite varios formatos de código de barras, incluyendo Code128 y códigos QR. Para obtener una lista completa de los formatos soportados, consulta la documentación de IronBarcode.

¿Cómo puedo guardar un código de barras como una imagen JPEG?

Puedes guardar un código de barras como una imagen JPEG utilizando el método SaveAsJpeg() después de generar el código de barras con el método BarcodeWriter.CreateBarcode() de IronBarcode.

¿Qué debo hacer si las dimensiones de mi código de barras son incorrectas?

Si las dimensiones especificadas de tu código de barras son incorrectas, IronBarcode puede ajustar el tamaño para mantener la conformidad o lanzar una excepción. Asegúrate de proporcionar dimensiones adecuadas para tu tipo de código de barras.

¿Cómo genero un código QR en C#?

Para generar un código QR en C#, utiliza el método QRCodeWriter.CreateQrCode() de IronBarcode. Proporciona el valor del código, tamaño, nivel de corrección de errores y versión del QR. Guarda el código QR usando métodos como SaveAsPng().

¿Qué factores afectan el nivel de corrección de errores de un código QR?

El nivel de corrección de errores de un código QR afecta su tolerancia a fallos y complejidad. IronBarcode ofrece cuatro niveles: Máximo, Alto, Medio y Bajo, cada uno influenciando la cantidad de datos que se puede recuperar si el código QR está dañado.

¿Puedo usar distintos tipos de datos para códigos de barras en .NET?

Sí, IronBarcode admite varios tipos de datos para los valores de los códigos de barras, incluyendo cadenas de texto, arreglos de bytes y MemoryStreams, permitiendo formatos de entrada flexibles para la creación de códigos de barras.

¿Cómo influye la versión del QR en la capacidad de datos de un código QR?

La versión del QR en IronBarcode determina la capacidad de datos y la complejidad del código QR. Las versiones varían de 1 a 40, permitiendo un mayor almacenamiento de datos en las versiones más altas.

¿Qué espacio de nombres debo incluir para usar IronBarcode?

Incluye el espacio de nombres IronBarcode en tu proyecto C# para acceder a todas las funcionalidades de creación y manipulación de códigos de barras proporcionadas por la biblioteca.

Hairil Hasyimi Bin Omar
Hairil Hasyimi Bin Omar
  Chatea con el equipo de ingeniería ahora
Ingeniero de Software
Como todos los grandes ingenieros, Hairil es un ávido aprendiz. Está refinando su conocimiento de C#, Python y Java, usando ese conocimiento para agregar valor a los miembros del equipo en Iron Software. Hairil se unió al equipo de Iron Software desde la Universiti Teknologi MARA en Malasia, donde se ...
Leer más
¿Listo para empezar?
Nuget Descargas 1,979,979 | Version: 2025.11 recién lanzado