1. IronBarcode
  2. Guías
  3. Establecer márgenes de códigos de barras

How to Add Margins to Barcodes

Curtis Chau
Curtis Chau
Actualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

For a barcode to be reliable, it is not just about the bars and spaces. The blank area surrounding the code, known as the "quiet zone" or margin, is just as critical. This quiet zone enables a scanner to distinguish the barcode from other elements on a label, such as text or graphics.

Without a sufficient margin, scans can fail or, worse, return incorrect data. This is particularly important in logistics and retail, where failed scans can result in significant time and financial losses.

IronBarcode provides straightforward methods for configuring these margins, ensuring your barcodes scan accurately every time. In this how-to, we'll explore the methods IronBarcode offers for setting barcode margins.

Get started with IronBarcode

Comience a usar IronBarcode en su proyecto hoy con una prueba gratuita.

Primer Paso:
green arrow pointer

How to Add Margins to Barcodes in C#

  1. Download the IronBarcode C# library to add margins to barcodes
  2. Generate a barcode with a string value with CreateBarcode
  3. Apply a uniform quiet zone to all four sides using SetMargins
  4. Apply a margin to each side of the barcode with SetMargins
  5. Save the barcode as an image with SaveAsPng

Set Margins on All Sides

The simplest and most direct way to ensure a proper quiet zone is by using the SetMargins method. This method accepts a single integer representing the number of pixels to add as a blank border to all four sides of the barcode.

In this example, we will create a barcode, set the margins to 100 pixels, and then save the result using SaveAsPng.

:path=/static-assets/barcode/content-code-examples/how-to/setting-margin-barcode.cs
using IronBarCode;

// Create a QR code
GeneratedBarcode qrcode = BarcodeWriter.CreateBarcode(
    "https://ironsoftware.com/csharp/barcode",
    BarcodeWriterEncoding.QRCode
);

// Set consistent margins around the QR code
qrcode.SetMargins(100);
// Save the QR code as a PNG image
qrcode.SaveAsPng("QRCode.png");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Output

barcode with margins

As you can see in the output, a uniform square margin of 100 pixels has been applied around the barcode.

Set Margins on Each Side

In addition to applying a uniform margin, IronBarcode allows you to specify individual margins for each side using an overload of the SetMargins method. This overload accepts four integer parameters representing the top, right, bottom, and left margins, respectively.

In the following example, we define specific margins: 10 pixels for the top and bottom, and 5 pixels for the left and right.

:path=/static-assets/barcode/content-code-examples/how-to/setting-multiple-margin.cs
using IronBarCode;

// Create a QR code
GeneratedBarcode qrcode = BarcodeWriter.CreateBarcode(
    "https://ironsoftware.com/csharp/barcode",
    BarcodeWriterEncoding.QRCode
);

// Set the QR code dimensions 10 pixel on top and bottom, 5 pixels on left and right
qrcode.SetMargins(10, 5, 10, 5);


// Save the QR code as a PNG file
qrcode.SaveAsPng("QRCodeValue.png");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Output

Individuals margin barcode

Preguntas Frecuentes

¿Qué es una zona tranquila en los códigos de barras?

Una zona tranquila, o margen, es el área en blanco que rodea un código de barras. Es crucial para que los lectores puedan distinguir el código de barras de otros elementos, como texto o gráficos.

¿Por qué son importantes los márgenes para el escaneo de códigos de barras?

Los márgenes evitan fallos de escaneo y la recuperación incorrecta de datos, ya que proporcionan una distinción clara entre el código de barras y otros elementos. Esto es especialmente vital en logística y comercio minorista para evitar pérdidas de tiempo y dinero.

¿Cómo puedo establecer márgenes en códigos de barras usando IronBarcode?

IronBarcode ofrece un método sencillo llamado 'SetMargins' que le permite aplicar márgenes uniformes o individuales a los códigos de barras, lo que garantiza escaneos precisos.

¿Puedo aplicar márgenes diferentes a cada lado de un código de barras con IronBarcode?

Sí, IronBarcode le permite especificar márgenes individuales para cada lado usando una sobrecarga del método 'SetMargins', aceptando cuatro parámetros enteros para los márgenes superior, derecho, inferior e izquierdo.

¿Cuál es el beneficio de utilizar IronBarcode para establecer márgenes de código de barras?

IronBarcode simplifica el proceso de configuración de márgenes de códigos de barras, garantizando que estén configurados correctamente para un escaneo confiable en todo momento.

¿Cómo empiezo a utilizar IronBarcode para establecer márgenes en mis códigos de barras?

Comience descargando la biblioteca IronBarcode de C#, genere un código de barras con "CreateBarcode" y luego aplique márgenes con "SetMargins". Finalmente, guarde el código de barras como imagen con "SaveAsPng".

¿Qué método proporciona IronBarcode para aplicar un margen uniforme a un código de barras?

IronBarcode proporciona el método 'SetMargins', que acepta un solo entero para aplicar un margen uniforme alrededor de los cuatro lados de un código de barras.

¿Es posible guardar un código de barras con márgenes como imagen usando IronBarcode?

Sí, después de configurar los márgenes deseados, puede guardar el código de barras como una imagen utilizando la función 'Guardar como Png' en IronBarcode.

Curtis Chau
Curtis Chau
  Chatea con el equipo de ingeniería ahora
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más
¿Listo para empezar?
Nuget Descargas 1,935,276 | Versión: 2025.11 recién lanzado