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

IronBarcode permite a los desarrolladores .NET generar códigos de barras e imágenes de códigos QR en C# con una sola línea de código, soportando múltiples formatos y tipos de imagen. Cree sistemas de gestión de inventarios, aplicaciones de venta al por menor o soluciones de procesamiento de documentos con una sólida API que crea códigos de barras de calidad profesional para una lectura fiable en los principales lectores.

Inicio rápido: crear y guardar un código de barras Code128 en una línea

Utilice la API de una línea de IronBarcode para crear un código de barras Code128 a partir de una cadena y guárdelo como una imagen PNG. Empiece inmediatamente: proporcione los datos, elija la codificación y el tamaño, y escriba su archivo de imagen.

  1. Instala IronBarcode con el Administrador 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

    Comienza a usar 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

¿Cómo generar BarCodes y guardarlos como archivos de imagen?

Además de leer códigos de barras, IronBarcode permite a los usuarios escribir códigos de barras con una codificación mínima. Llame al método CreateBarcode() de la clase BarcodeWriter, especificando el valor, tipo, ancho y altura del código de barras en los parámetros del método. Esto genera un objeto GeneratedBarcode, que se puede guardar como un archivo de imagen usando el método SaveAs().

¿Qué tipos de datos puedo utilizar para los valores de los códigos de barras?

El método BarcodeWriter.CreateBarcode() acepta múltiples tipos de datos para los valores de códigos de barras: byte[] array, MemoryStream, y string. La longitud de las cadenas y los caracteres aceptados varían según el tipo de código de barras; consulte nuestra documentación de la API para obtener más información. Code128 soporta el conjunto completo de caracteres ASCII, mientras que UPC-A requiere exactamente 12 dígitos numéricos. Para datos binarios, use byte[] array para codificar estructuras de datos complejas.

¿Qué tipos de codificación de códigos de barras se admiten?

IronBarcode admite numerosos formatos de códigos de barras; consulte nuestro artículo Formatos de códigos de barras admitidos para ver la lista completa. Los formatos más populares incluyen:

  • Códigos de barras lineales/1D: Code128, Code39, UPC-A, UPC-E, EAN-8, EAN-13
  • Códigos de barras 2D: QR Code, Data Matrix, PDF417, Aztec
  • Formatos especializados: MaxiCode para envío, Databar para retail

Cada formato tiene un uso específico. Code128 maneja bien los datos alfanuméricos generales, mientras que los códigos QR ofrecen una corrección de errores superior para escaneo móvil.

¿Cómo afectan los ajustes de anchura y altura a mi BarCode?

Establezca las dimensiones de la imagen del código de barras de salida en píxeles. Las medidas por defecto son 250 px para ambos. Algunos tipos de códigos de barras (QR, PDF417) requieren dimensiones específicas para cumplir con las normativas. Cuando las dimensiones de entrada no coinciden con los requisitos, el código de barras se genera con las dimensiones requeridas y los espacios en blanco rellenan el espacio restante. Las dimensiones demasiado pequeñas provocan una excepción.

Para una digitalización óptima:

  • Códigos de barras lineales: Mantenga el ancho significativamente mayor que la altura
  • Códigos de barras 2D: Use dimensiones cuadradas para códigos QR (por ejemplo, 250x250)
  • Calidad de impresión: las dimensiones de píxel más altas mejoran la calidad de impresión en tamaños físicos más grandes

¿A qué formatos de imagen puedo exportar códigos de barras?

El objeto GeneratedBarcode de BarcodeWriter.CreateBarcode() se guarda en varios formatos de imagen usando métodos específicos de SaveAs():

  • SaveAsGif(): Guarda como archivo de imagen GIF
  • SaveAsJpeg(): Guarda como archivo de imagen JPEG
  • SaveAsPng(): Guarda como archivo de imagen PNG (recomendado para la web)
  • SaveAsTiff(): Guarda como archivo de imagen TIFF (ideal para archivo/impresión)
  • SaveAsWindowsBitmap(): Guarda como archivo de imagen BMP
  • SaveAsImage(): Método general: especifique la extensión de formato en la ruta del archivo

Además, exporte códigos de barras como flujos para el procesamiento en memoria o crea códigos de barras como documentos PDF para la integración de documentos.

¿Cómo generar un código de barras y guardarlo como archivo de imagen?

Utilice BarcodeWriter.CreateBarcode() para crear un código de barras Code128 y guárdelo como una imagen JPEG:

using IronBarCode;

// Create a basic barcode
BarcodeWriter.CreateBarcode("IronBarcode123", BarcodeEncoding.Code128, 200, 100).SaveAsJpeg("OneDBarcode.jpeg");

// Create a barcode with custom options
var myBarcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128, 300, 150);

// Apply styling
myBarcode.AddBarcodeValueTextBelowBarcode();
myBarcode.SetMargins(10);

// Save in multiple formats
myBarcode.SaveAsJpeg("product-barcode.jpg");
myBarcode.SaveAsPng("product-barcode.png");
using IronBarCode;

// Create a basic barcode
BarcodeWriter.CreateBarcode("IronBarcode123", BarcodeEncoding.Code128, 200, 100).SaveAsJpeg("OneDBarcode.jpeg");

// Create a barcode with custom options
var myBarcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128, 300, 150);

// Apply styling
myBarcode.AddBarcodeValueTextBelowBarcode();
myBarcode.SetMargins(10);

// Save in multiple formats
myBarcode.SaveAsJpeg("product-barcode.jpg");
myBarcode.SaveAsPng("product-barcode.png");
Imports IronBarCode

' Create a basic barcode
BarcodeWriter.CreateBarcode("IronBarcode123", BarcodeEncoding.Code128, 200, 100).SaveAsJpeg("OneDBarcode.jpeg")

' Create a barcode with custom options
Dim myBarcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128, 300, 150)

' Apply styling
myBarcode.AddBarcodeValueTextBelowBarcode()
myBarcode.SetMargins(10)

' Save in multiple formats
myBarcode.SaveAsJpeg("product-barcode.jpg")
myBarcode.SaveAsPng("product-barcode.png")
$vbLabelText   $csharpLabel
Código de barras unidimensional generado con barras verticales negras que muestra un ejemplo de salida del código de creación de códigos de barras

Para opciones de estilo avanzadas, consulte nuestra guía sobre personalización de estilos de códigos de barras.

¿Cómo generar códigos QR y guardarlos como archivos de imagen?

los códigos QR, clasificados como códigos de barras bidimensionales, son totalmente compatibles con IronBarcode. Su versatilidad, atractivo estético y características personalizables han impulsado su adopción generalizada, desde menús de restaurantes hasta sistemas de pago.

La creación de códigos QR requiere diferentes métodos debido a su complejidad. Llame al método CreateQrCode() de la clase QRCodeWriter, que acepta 4 argumentos: el valor del código de barras, el tamaño de salida del código QR, el campo enum QRCodeWriter.QrErrorCorrectionLevel, y QRVersion.

¿Qué tipos de datos puedo utilizar para los valores del código QR?

QRCodeWriter.CreateQrCode() acepta valores numéricos, alfabéticos o alfanuméricos como tipos byte[] array, MemoryStream, o System.String. Los códigos QR sobresalen almacenando:

  • URLs: Dirigen a los usuarios a sitios web o páginas de destino
  • Texto: Almacena hasta 4,296 caracteres alfanuméricos
  • Datos binarios: Codifica archivos o estructuras de datos complejas
  • Datos estructurados: vCards, credenciales de WiFi o información de pago

Para obtener información sobre la compatibilidad con Unicode y los caracteres internacionales, consulte nuestro tutorial escritura de códigos de barras Unicode.

¿Cómo configuro el tamaño del código QR?

Especifique el tamaño del código QR directamente como tipo Int32 en píxeles (px). El tamaño por defecto es de 500 px. Considera estos factores:

  • Medio de visualización: Las pantallas típicamente necesitan de 200 a 400px
  • Aplicaciones de impresión: Use 600px o más para una impresión de calidad
  • Distancia de escaneado: Los códigos más grandes se escanean mejor desde distancias mayores

¿Qué es el nivel de corrección de errores QR y por qué es importante?

QRErrorCorrectionLevel determina la tolerancia a fallas, con cuatro niveles: Más alto, Alto, Medio, y Bajo. Los niveles de corrección más altos crean códigos QR más complejos que resisten los errores de lectura incluso cuando están dañados o parcialmente oscurecidos.

QRErrorCorrectionLevel.Highest

Genera el código QR más complejo con un 30% de corrección de errores. Admite estampación de logotipos o gráficos de imagen. Ideal para personalizar códigos QR con logotipos.

Código QR generado con el máximo nivel de corrección de errores que muestra un patrón denso en blanco y negro con cuadrados de posicionamiento

QRErrorCorrectionLevel.High

Se aplica un 25% de corrección de errores. Menos complejo que el nivel más alto. Equilibra la durabilidad con la capacidad de datos.

Ejemplo de código QR que muestra un alto nivel de corrección de errores con un patrón de datos denso y elementos de posicionamiento estándar

QRErrorCorrectionLevel.Medium

Se aplica un 15% de corrección de errores. Produce códigos QR más rápido pero con mayor susceptibilidad a errores. Adecuado para la mayoría de aplicaciones empresariales con una impresión clara.

Ejemplo de código QR generado que muestra una matriz de datos en blanco y negro con marcadores de posición de las esquinas

QRErrorCorrectionLevel.Low

Aplica un 7% de corrección de errores, creando el código QR menos complejo. Utilizar cuando se requiera la máxima capacidad de datos con condiciones óptimas de escaneado.

Ejemplo de código QR generado con un nivel bajo de corrección de errores que muestra un patrón de módulo estándar en blanco y negro

¿Cuándo debo utilizar diferentes versiones de QR?

La versión QR (1-40) determina la complejidad de los símbolos y la capacidad de los datos. Las versiones superiores producen códigos más complejos que almacenan más datos. Una versión demasiado baja puede causar problemas a la hora de codificar grandes cantidades de datos. La versión 0 asigna automáticamente la versión adecuada en función del valor codificado. See QR Version for more information.

¿Cómo crear una imagen de código QR con una configuración específica?

Use QRCodeWriter.CreateQrCode() para escribir un código QR y guardarlo como imagen:

using IronBarCode;

// Basic QR code creation
QRCodeWriter.CreateQrCode("IronBarcode1234", 250, QRCodeWriter.QrErrorCorrectionLevel.Medium, qrVersion: 0).SaveAsJpeg("QRMedium.jpeg");

// Advanced QR code with custom styling
var qrCode = QRCodeWriter.CreateQrCode("https://ironsoftware.com", 500, QRCodeWriter.QrErrorCorrectionLevel.High);

// Add logo and styling
qrCode.AddLogo("logo.png");
qrCode.ChangeBarCodeColor(System.Drawing.Color.DarkBlue);

// Save in multiple formats
qrCode.SaveAsPng("styled-qr.png");
qrCode.SaveAsPdf("styled-qr.pdf");
using IronBarCode;

// Basic QR code creation
QRCodeWriter.CreateQrCode("IronBarcode1234", 250, QRCodeWriter.QrErrorCorrectionLevel.Medium, qrVersion: 0).SaveAsJpeg("QRMedium.jpeg");

// Advanced QR code with custom styling
var qrCode = QRCodeWriter.CreateQrCode("https://ironsoftware.com", 500, QRCodeWriter.QrErrorCorrectionLevel.High);

// Add logo and styling
qrCode.AddLogo("logo.png");
qrCode.ChangeBarCodeColor(System.Drawing.Color.DarkBlue);

// Save in multiple formats
qrCode.SaveAsPng("styled-qr.png");
qrCode.SaveAsPdf("styled-qr.pdf");
Imports IronBarCode

' Basic QR code creation
QRCodeWriter.CreateQrCode("IronBarcode1234", 250, QRCodeWriter.QrErrorCorrectionLevel.Medium, qrVersion:=0).SaveAsJpeg("QRMedium.jpeg")

' Advanced QR code with custom styling
Dim qrCode = QRCodeWriter.CreateQrCode("https://ironsoftware.com", 500, QRCodeWriter.QrErrorCorrectionLevel.High)

' Add logo and styling
qrCode.AddLogo("logo.png")
qrCode.ChangeBarCodeColor(System.Drawing.Color.DarkBlue)

' Save in multiple formats
qrCode.SaveAsPng("styled-qr.png")
qrCode.SaveAsPdf("styled-qr.pdf")
$vbLabelText   $csharpLabel
Ejemplo de código QR que muestra un nivel medio de corrección de errores con patrones de búsqueda estándar y estructura de codificación de datos

El código codifica un valor alfanumérico a 250 píxeles con corrección de errores media. La versión 0 permite al programa seleccionar la versión de código QR adecuada. SaveAsJpeg() acepta el nombre del archivo con extensión JPEG.

Bestes prácticas para la generación de imágenes de códigos de barras

Para aplicaciones de producción:

  1. Elija el formato adecuado: PNG para la web, TIFF para archivo, JPEG para uso general
  2. Pruebe el escaneo: Verifique códigos de barras con múltiples dispositivos de escaneo
  3. Aplicar márgenes adecuados: Use configuración de margen de código de barras para un escaneo confiable
  4. Considere el rendimiento: Explore opciones asincrónicas y de multithreading para generación de alto volumen

Para obtener más ejemplos y técnicas, visite nuestro Tutorial del generador de imágenes de códigos de barras en C#.

Preguntas Frecuentes

¿Cómo puedo crear una imagen de código de barras en C# con una sola línea de código?

Con IronBarcode, puede crear una imagen de código de barras en una línea utilizando el método BarcodeWriter.CreateBarcode(). Simplemente pase sus datos, tipo de codificación, ancho y alto, y luego guárdelo como un archivo de imagen. Por ejemplo: IronBarCode.BarcodeWriter.CreateBarcode("Sample123", BarcodeEncoding.Code128, 250, 100).SaveAsPng("Barcode.png");

¿Qué tipos de datos puedo codificar en códigos de barras?

El método BarcodeWriter.CreateBarcode() de IronBarcode acepta varios tipos de datos, como matrices de bytes, MemoryStreams y cadenas. La longitud de las cadenas y los caracteres aceptados varían según el tipo de código de barras: Code128 admite todo el conjunto de caracteres ASCII, mientras que UPC-A requiere exactamente 12 dígitos numéricos. Para los datos binarios, puede utilizar matrices de bytes para codificar estructuras de datos complejas.

¿Qué formatos de código de barras se admiten para la generación de imágenes?

IronBarcode admite numerosos formatos de códigos de barras, incluidos códigos de barras lineales/1D (Code128, Code39, UPC-A, UPC-E, EAN-8, EAN-13), códigos de barras 2D (QR Code, Data Matrix, PDF417, Aztec) y formatos especializados como MaxiCode para envíos y Databar para comercios. Cada formato tiene un uso específico, con el Código 128 gestionando datos alfanuméricos generales y los códigos QR ofreciendo una corrección de errores superior para el escaneado móvil.

¿Cómo establezco las dimensiones de mi imagen de código de barras?

Puede establecer las dimensiones de la imagen del código de barras en píxeles directamente en los parámetros del método CreateBarcode(). IronBarcode utiliza medidas por defecto de 250px tanto para la anchura como para la altura. Algunos tipos de códigos de barras como QR y PDF417 pueden requerir dimensiones específicas para su cumplimiento, y la biblioteca se ajusta automáticamente cuando las dimensiones de entrada no coinciden con los requisitos.

¿En qué formatos de archivo de imagen puedo guardar los códigos de barras generados?

IronBarcode le permite guardar los códigos de barras generados en múltiples formatos de imagen utilizando el método SaveAs(). Puede guardar como PNG utilizando SaveAsPng(), así como otros formatos comunes como JPEG, BMP y TIFF. El objeto GeneratedBarcode devuelto por CreateBarcode() proporciona varios métodos de guardado para diferentes tipos de archivo.

¿Puedo generar códigos QR además de códigos de barras tradicionales?

Sí, IronBarcode es totalmente compatible con la generación de códigos QR junto con los códigos de barras tradicionales. Puede crear códigos QR utilizando el mismo método CreateBarcode() especificando BarcodeEncoding.QRCode como tipo de codificación. Los códigos QR ofrecen ventajas como una corrección de errores superior y son ideales para aplicaciones de escaneado móvil.

¿IronBarcode proporciona soporte para personalizar la apariencia de los códigos de barras?

Sí, IronBarcode proporciona amplias opciones de personalización para la apariencia de los códigos de barras, incluidas color, tamaño y anotaciones de texto, permitiéndote adaptar los códigos de barras a tus requisitos de diseño específicos.

¿Cómo puede IronBarcode ayudar a mejorar la eficiencia de los procesos de negocio?

IronBarcode mejora la eficiencia de los procesos de negocio al permitir la generación y lectura rápida y precisa de códigos de barras, reduciendo errores de entrada de datos manuales y mejorando el seguimiento de inventario y activos.

¿Qué habilidades de programación se necesitan para implementar IronBarcode en un proyecto?

El conocimiento básico de programación en C# es suficiente para implementar IronBarcode en un proyecto, ya que proporciona métodos sencillos y documentación completa para guiar a los desarrolladores.

¿Es IronBarcode adecuado para tanto proyectos pequeños como aplicaciones empresariales grandes?

IronBarcode está diseñado para ser escalable y versátil, haciéndolo adecuado para proyectos pequeños, así como para aplicaciones empresariales grandes que requieren soluciones robustas de códigos de barras.

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 2,240,258 | Versión: 2026.5 just released
Still Scrolling Icon

¿Aún desplazándote?

¿Quieres una prueba rápida? PM > Install-Package BarCode
ejecuta una muestra observa cómo tu cadena se convierte en un código de barras.