Cómo crear imágenes de códigos de barras en C# con IronBarcode
IronBarcode permite a los desarrolladores .NET generar imágenes de código de barras y códigos QR en C# con una sola línea de código, soportando múltiples formatos y tipos de imagen. Construye sistemas de gestión de inventario, aplicaciones de ventas o soluciones de procesamiento de documentos con una API confiable que crea códigos de barras de calidad profesional para un escaneo confiable en todos los lectores principales.
Inicio rápido: crear y guardar un código de barras Code128 en una líneaUtilice la API de una línea de IronBarcode para crear un código de barras Code128 a partir de una cadena y guardarlo como una imagen PNG. Comience de inmediato: proporcione los datos, elija la codificación y el tamaño, y escriba su archivo de imagen.
-
1Instalar IronBarcode con NuGet Package Manager
-
2Copie y ejecute este fragmento de código.
IronBarCode.BarcodeWriter.CreateBarcode("Sample123", BarcodeEncoding.Code128, 250, 100).SaveAsPng("Barcode.png");IronBarCode.BarcodeWriter.CreateBarcode("Sample123", BarcodeEncoding.Code128, 250, 100).SaveAsPng("Barcode.png")IronBarCode.BarcodeWriter.CreateBarcode("Sample123", BarcodeEncoding.Code128, 250, 100).SaveAsPng("Barcode.png") -
3Despliegue para probar en su entorno real
Empiece a usar IronBarcode en su proyecto hoy con una prueba gratuita
Flujo de trabajo mínimo (5 pasos)
- Descargar la biblioteca C# IronBarcode
- Generar códigos de barras y guardarlos como archivos de imagen
- 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, el cual puede guardarse como un archivo de imagen utilizando 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 los códigos de barras: byte[] array, MemoryStream y string. Las longitudes de las cadenas y los caracteres aceptados varían según el tipo de código de barras; consulte nuestra documentación de API para más detalles. Code128 admite el conjunto completo de caracteres ASCII, mientras que UPC-A requiere exactamente 12 dígitos numéricos. Para datos binarios, utilice 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ódigo de barras; consulte nuestro artículo Formatos de código de barras compatibles para ver la lista completa. Los formatos 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:
MaxiCodepara envíos,Databarpara ventas
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 el 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 el cumplimiento. 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 un ancho significativamente mayor que la altura
- Códigos de barras 2D: Utilice dimensiones cuadradas para los códigos QR (por ejemplo, 250x250)
- Calidad de impresión: Mayores dimensiones de píxeles 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 utilizando métodos específicos SaveAs():
SaveAsGif(): Se guarda como archivo de imagen GIFSaveAsJpeg(): Se guarda como archivo de imagen JPEGSaveAsPng(): Se guarda como archivo de imagen PNG (recomendado para la web)SaveAsTiff(): Se guarda como archivo de imagen TIFF (ideal para archivo/impresión)SaveAsWindowsBitmap(): Se guarda como archivo de imagen BMPSaveAsImage(): Método general - especifique la extensión del formato en la ruta del archivo
Además, exporte códigos de barras como flujos para procesamiento en memoria o cree 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")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")
Para opciones avanzadas de estilo, consulte nuestra guía sobre personalización de estilos de código 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, tamaño de salida del código QR, 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 son excelentes para almacenar:
- URLs: Dirija a los usuarios a sitios web o páginas de aterrizaje
- Texto: Almacene hasta 4,296 caracteres alfanuméricos
- Datos binarios: Codifique archivos o estructuras de datos complejas
- Datos estructurados: vCards, credenciales de WiFi o información de pago
Para soporte Unicode y caracteres internacionales, consulte nuestro tutorial sobre 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 suelen necesitar de 200 a 400px
- Aplicaciones de impresión: Utilice 600px o más para una impresión de calidad
- Distancia de escaneo: Los códigos más grandes se escanean mejor desde mayores distancias
¿Qué es el nivel de corrección de errores QR y por qué es importante?
QRErrorCorrectionLevel determina la tolerancia a fallos, 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.

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.

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.

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.

¿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. Consulte Versión QR para más información.
¿Cómo crear una imagen de código QR con una configuración específica?
Utilice 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 logo and custom styling
var qrCode = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com", new QRCodeLogo("logo.png"), 500);
// Apply styling
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 logo and custom styling
var qrCode = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com", new QRCodeLogo("logo.png"), 500);
// Apply styling
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 logo and custom styling
Dim qrCode = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com", New QRCodeLogo("logo.png"), 500)
' Apply styling
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 logo and custom styling
Dim qrCode = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com", New QRCodeLogo("logo.png"), 500)
' Apply styling
qrCode.ChangeBarCodeColor(System.Drawing.Color.DarkBlue)
' Save in multiple formats
qrCode.SaveAsPng("styled-qr.png")
qrCode.SaveAsPdf("styled-qr.pdf")
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 de 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:
- Elija el formato correcto: PNG para web, TIFF para archivo, JPEG para uso general
- Pruebe el escaneo: Verifique códigos de barras con múltiples dispositivos de escaneo
- Aplique márgenes adecuados: Use configuraciones de margen de código de barras para un escaneo confiable
- Considere el rendimiento: Explore opciones asincrónicas y de multihilo para generación de alto volumen
Para ejemplos y técnicas adicionales, visite nuestro tutorial de Generador de Imágenes de Código de Barras en C#.
Preguntas frecuentes
¿Cuál es la forma más sencilla de crear una imagen de código de barras en C# usando IronBarcode?
IronBarcode proporciona una API de una sola línea para crear imágenes de códigos de barras. Puede usar el método BarcodeWriter.CreateBarcode() para generar un código de barras Code128 a partir de una cadena con dimensiones especificadas y guardarlo como una imagen PNG.
¿Cuáles son algunos formatos de códigos de barras populares soportados por IronBarcode?
IronBarcode admite varios formatos de códigos de barras como Code128, Code39, UPC-A, QR Code, Data Matrix y muchos más. Cada formato es adecuado para casos de uso específicos como ventas al por menor, gestión de inventario o procesamiento de documentos.
¿Cómo puedo guardar una imagen de código de barras generada en diferentes formatos de archivo usando IronBarcode?
El objeto GeneratedBarcode en IronBarcode puede guardarse en varios formatos, incluyendo PNG, JPEG, GIF, BMP y TIFF. Use métodos como SaveAsPng(), SaveAsJpeg() o SaveAsTiff() para guardar su imagen de código de barras en el formato deseado.
¿Puede IronBarcode generar códigos QR con niveles específicos de corrección de errores?
Sí, IronBarcode permite establecer niveles de corrección de errores QR que van de Bajo a Máximo. Esta característica asegura que sus códigos QR sean escaneables incluso si están dañados o parcialmente ocultos.
¿Qué tipos de datos pueden codificarse como valores de código de barras en IronBarcode?
IronBarcode puede codificar tipos de datos que incluyen byte[] array, MemoryStream y string. Los diferentes formatos de códigos de barras tienen requisitos específicos para tipos de datos y conjuntos de caracteres.
¿Cómo garantiza IronBarcode el cumplimiento de los requerimientos de dimensiones de códigos de barras?
IronBarcode le permite especificar ancho y altura en píxeles para sus imágenes de código de barras. Si las dimensiones especificadas no cumplen con los requisitos del formato, IronBarcode las ajusta automáticamente para incluir el espacio en blanco necesario.
¿Cuáles son las capacidades de los códigos QR generados usando IronBarcode?
Los códigos QR generados por IronBarcode pueden almacenar una variedad de tipos de datos como URLs, texto, datos binarios y datos estructurados como vCards o credenciales de WiFi. Ofrecen flexibilidad y personalización para diversas aplicaciones.
¿Cómo puedo personalizar la apariencia de las imágenes de códigos de barras con IronBarcode?
IronBarcode ofrece opciones de personalización como cambiar colores, ajustar márgenes y aplicar texto debajo del código de barras. Además, puede incrustar logotipos dentro de códigos QR para propósitos de marca.
¿Por qué es importante elegir el formato de imagen correcto para la generación de códigos de barras?
Elegir el formato de imagen correcto asegura calidad óptima para usos específicos. Por ejemplo, PNG es mejor para visualización web, TIFF para propósitos de archivo y JPEG para uso general. La selección adecuada del formato promueve un escaneo fiable y la integridad de los datos.
¿Qué prácticas recomendadas debo seguir al generar imágenes de códigos de barras con IronBarcode?
Las prácticas recomendadas incluyen elegir el formato de imagen adecuado, probar los códigos de barras con múltiples escáneres, establecer márgenes apropiados y considerar las necesidades de rendimiento utilizando técnicas asincrónicas y multihilo para generación en alto volumen.