1. IronBarcode
  2. Guides pratiques
  3. Définir les marges des codes-barres

How to Add Margins to Barcodes

Curtis Chau
Curtis Chau
Mis à jour:
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

Commencez à utiliser IronBarcode dans votre projet aujourd'hui avec un essai gratuit.

Première étape :
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

Questions Fréquemment Posées

Qu'est-ce qu'une zone silencieuse dans les codes-barres ?

La zone de silence, ou marge, est l'espace vide qui entoure un code-barres. Elle est essentielle pour permettre aux lecteurs de distinguer le code-barres des autres éléments, comme du texte ou des graphiques.

Pourquoi les marges sont-elles importantes pour la lecture des codes-barres ?

Les marges permettent d'éviter les erreurs de lecture et la récupération de données incorrectes en assurant une distinction claire entre le code-barres et les autres éléments. Ceci est particulièrement important dans la logistique et le commerce de détail pour éviter les pertes de temps et d'argent.

Comment puis-je définir des marges sur les codes-barres avec IronBarcode ?

IronBarcode propose une méthode simple appelée « SetMargins » qui permet d'appliquer des marges uniformes ou individuelles aux codes-barres, garantissant ainsi des scans précis.

Est-il possible d'appliquer des marges différentes de chaque côté d'un code-barres avec IronBarcode ?

Oui, IronBarcode vous permet de spécifier des marges individuelles pour chaque côté en utilisant une surcharge de la méthode 'SetMargins', acceptant quatre paramètres entiers pour les marges supérieure, droite, inférieure et gauche.

Quel est l'avantage d'utiliser IronBarcode pour définir les marges des codes-barres ?

IronBarcode simplifie le processus de configuration des marges des codes-barres, garantissant ainsi qu'elles soient correctement paramétrées pour une lecture fiable à chaque fois.

Comment puis-je commencer à utiliser IronBarcode pour définir les marges de mes codes-barres ?

Commencez par télécharger la bibliothèque IronBarcode C#, générez un code-barres avec la fonction « CreateBarcode », puis définissez les marges avec « SetMargins ». Enfin, enregistrez le code-barres au format image avec la fonction « SaveAsPng ».

Quelle méthode IronBarcode propose-t-il pour appliquer une marge uniforme à un code-barres ?

IronBarcode propose la méthode « SetMargins », qui accepte un seul entier pour appliquer une marge uniforme autour des quatre côtés d'un code-barres.

Est-il possible d'enregistrer un code-barres avec marges sous forme d'image en utilisant IronBarcode ?

Oui, après avoir défini les marges souhaitées, vous pouvez enregistrer le code-barres sous forme d'image à l'aide de la fonction « SaveAsPng » d'IronBarcode.

Curtis Chau
Curtis Chau
  Discutez maintenant avec l'équipe d'ingénierie
Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Lire la suite
Prêt à commencer?
Nuget Téléchargements 1,935,276 | Version : 2025.11 vient de sortir