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

Comment ajouter des marges aux BarCodes en C#;

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

IronBarcode fournit deux méthodes pour ajouter des marges (zones silencieuses) aux codes-barres en C# : utilisez SetMargins() avec un seul paramètre pour des marges uniformes sur tous les côtés, ou utilisez le SetMargins() surchargé avec quatre paramètres pour définir des marges individuelles pour le haut, la droite, le bas et les côtés gauches.

Démarrage rapide : ajouter des marges aux BarCodes en C#

  1. Installez IronBarcode via NuGet Package Manager
  2. Créez votre code-barres à l'aide de BarcodeWriter.CreateBarcode()
  3. Appliquez des marges uniformes avec SetMargins(100) pour 100px sur tous les côtés
  4. Ou définissez des marges individuelles avec SetMargins(top, right, bottom, left)
  5. Enregistrez le résultat à l'aide de SaveAsPng() ou d'autres méthodes de formatage

```cs {.cs .numberLines startFrom="1"} :title=Quickstart // Exemple rapide - marge uniforme de 50 px var barcode = BarcodeWriter.CreateBarcode("Hello World", BarcodeWriterEncoding.QRCode) ; barCode.SetMargins(50) ; barcode.SaveAsPng("barcode-with-margin.png") ;


Pour qu'un BarCode soit fiable, il faut plus que des barres et des espaces. La zone vierge entourant le code, appelée "zone de silence" ou marge, est tout aussi importante. Cette zone silencieuse permet aux scanners de distinguer le code-barres des autres éléments d'une étiquette, tels que le texte ou les graphiques.

Sans marges suffisantes, les numérisations peuvent échouer ou renvoyer des données incorrectes. Ceci est particulièrement important dans les domaines de la logistique et de la vente au détail, où les scans ratés entraînent des pertes de temps et d'argent considérables. Les [formats de codes-barres pris en charge](https://ironsoftware.com/csharp/barcode/get-started/supported-barcode-formats/) dans IronBarcode ont chacun des exigences spécifiques en matière de marge pour garantir des performances de lecture optimales.

IronBarcode fournit des méthodes simples pour configurer ces marges, garantissant ainsi que vos codes-barres soient scannés avec précision à chaque fois. Ces paramètres de marge fonctionnent de manière transparente avec toutes les fonctionnalités [génération d'images de codes-barres](https://ironsoftware.com/csharp/barcode/how-to/create-barcode-images/). Dans ce guide, nous allons explorer les méthodes qu'offre IronBarcode pour définir les marges des codes-barres.

<h3>Commencez avec IronBarcode</h3>


		

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


	

		
Première étape :

		

			
green arrow pointer

		

        
		
	






<hr>

<div class="hsg-featured-snippet">
    <h2>Comment ajouter des marges aux codes-barres en C#</h2>
    <ol>
        <li><a class="js-modal-open" data-modal-id="trial-license-after-download" href="https://www.nuget.org/packages/BarCode/">Téléchargez la bibliothèque IronBarcode C# pour ajouter des marges aux codes-barres.</a></li>
        <li>Générez un code-barres avec une valeur de type chaîne de caractères grâce à <code>CreateBarcode</code> </li>
        <li>Appliquez une zone de silence uniforme sur les quatre côtés à l&#39;aide de <code>SetMargins</code></li> 
        <li>Appliquez une marge de chaque côté du code-barres avec <code>SetMargins</code></li>
        <li>Enregistrez le code-barres sous forme d&#39;image avec <code>SaveAsPng</code></li>
    </ol>
</div>

<hr>

## Comment définir des marges uniformes sur tous les côtés?

<TODO : Ajouter une image ici -->
<!-- ![Diagramme illustrant la mise en œuvre de l'option "définir les marges sur tous les côtés"](/static-assets/images/TODO/set-margins-on-all-sides-code_illustration.webp) -->
<Description : Diagramme ou capture d'écran illustrant le concept de code -->

La méthode `SetMargins` est le moyen le plus simple de garantir une zone de silence appropriée. Cette méthode accepte un seul entier représentant le nombre de pixels à ajouter comme bordure vide aux quatre côtés du code-barres. Cette approche est particulièrement utile pour [créer des QR codes](https://ironsoftware.com/csharp/barcode/examples/csharp-create-qr-code/) ou d'autres formats de codes-barres 2D qui nécessitent un espacement cohérent.

Dans cet exemple, nous créons un BarCode, définissons les marges à 100 pixels et enregistrons le résultat à l'aide de `SaveAsPng`. Les paramètres de marge peuvent être combinés avec d'autres [options de style de code-barres](https://ironsoftware.com/csharp/barcode/how-to/customize-barcode-style/) pour une personnalisation complète.

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

À quoi ressemble la sortie avec des marges uniformes?

Code QR avec marges blanches appliquées sur les quatre côtés montrant un espacement approprié autour des éléments du code-barres

Comme le montre la sortie, une marge carrée uniforme de 100 pixels a été appliquée autour du code-barres. Cela permet de créer une zone de silence optimale qui garantit un balayage fiable à travers différents scénarios de lecture de codes-barres.

Pourquoi des marges uniformes sont-elles importantes pour la numérisation ? Des marges uniformes garantissent des zones de silence cohérentes de tous les côtés, ce qui est crucial pour les scanners omnidirectionnels couramment utilisés dans les environnements de vente au détail. Une zone silencieuse cohérente permet d'éviter les lectures partielles et la mauvaise interprétation des graphiques ou textes adjacents comme faisant partie des données du code-barres. Cela devient particulièrement important lorsqu'il s'agit de [codes-barres imparfaits et de scénarios de correction d'image](https://ironsoftware.com/csharp/barcode/examples/imperfect-barcode-with-image-correction/). Lorsque vous générez des codes-barres pour des applications professionnelles, des marges appropriées contribuent à la [tolérance au défaut](https://ironsoftware.com/csharp/barcode/features/fault-tolerance/) globale de votre système de codes-barres. La marge agit comme une zone tampon qui aide les scanners à identifier clairement où commence et où finit le code-barres, même dans des conditions de lecture moins qu'idéales.

Comment puis-je définir des marges différentes pour chaque côté ? En plus d'appliquer des marges uniformes, IronBarcode vous permet de spécifier des marges individuelles pour chaque côté à l'aide d'une surcharge de la méthode `SetMargins`. Cette surcharge accepte quatre paramètres entiers représentant respectivement les marges supérieure, droite, inférieure et gauche. Cette flexibilité est particulièrement précieuse lors de la [création de codes-barres sous forme de PDF](https://ironsoftware.com/csharp/barcode/how-to/create-barcode-as-pdf/) où un contrôle précis de la mise en page est essentiel. Dans l'exemple suivant, nous définissons des marges spécifiques : 10 pixels en haut et en bas, et 5 pixels à gauche et à droite. Cette configuration de marge asymétrique est utile lors de l'intégration de codes-barres dans des mises en page de documents existants ou lors de l'utilisation de [styles de codes-barres personnalisés](https://ironsoftware.com/csharp/barcode/examples/csharp-custom-barcode/). ```cs :path=/static-assets/barcode/content-code-examples/how-to/setting-multiple-margin.cs ``` ### À quoi ressemble le résultat avec des marges individuelles?
Exemple de code QR montrant l'espacement des marges autour des marqueurs de positionnement et de la matrice de données

Quand dois-je utiliser des marges différentes de chaque côté ? Les différentes marges sont utiles lors de l'intégration de codes-barres dans des conceptions d'étiquettes existantes avec des contraintes de mise en page spécifiques. Par exemple, vous pourriez avoir besoin de marges minimales en haut et en bas pour respecter les restrictions de hauteur tout en conservant des marges plus larges à gauche et à droite pour les angles d'approche des scanners. Cette technique est souvent associée à d'autres [fonctionnalités de génération de codes-barres](https://ironsoftware.com/csharp/barcode/features/generate/) pour créer des solutions de codes-barres de qualité professionnelle. Le contrôle individuel des marges devient particulièrement important lorsque - Intégrer des BarCodes dans des documents avec des exigences d'espacement serrées - Création d'étiquettes devant être conformes à des normes spécifiques à l'industrie - Optimiser le placement des codes-barres pour des types de scanners ou des orientations spécifiques - Intégration dans des mises en page d'impression existantes où l'espace est restreint ### Quelles sont les lignes directrices habituelles en matière de taille des marges? Les normes industrielles recommandent généralement des zones silencieuses minimales de 10 fois la largeur de la barre la plus étroite (dimension X) pour les codes-barres linéaires, ou d'au moins 4 largeurs de module pour les codes 2D comme le QR. Toutefois, des marges plus importantes améliorent généralement la fiabilité de la numérisation, en particulier dans des conditions difficiles. Pour une mise en œuvre pratique, tenez compte des lignes directrices suivantes : - **Codes QR** : Minimum 4 modules de largeur sur tous les côtés - 128 : Zone silencieuse minimale 10X (10 fois la largeur de la barre étroite) - **PDF417** : Minimum 2 modules de largeur sur tous les côtés - **Matrice de données** : Minimum 1 module de largeur sur tous les côtés Ces normes garantissent la compatibilité avec divers équipements de numérisation et conditions environnementales. En cas de doute, utilisez des marges plus importantes pour maximiser le taux de réussite de la numérisation. Les paramètres de marge d'IronBarcode s'intègrent parfaitement à d'autres fonctionnalités telles que [les paramètres de correction des erreurs](https://ironsoftware.com/csharp/barcode/how-to/error-correction/) pour créer des solutions de codes-barres robustes qui fonctionnent de manière fiable dans les applications du monde réel.

Questions Fréquemment Posées

Comment ajouter des marges à un BarCode en C# ?

IronBarcode fournit deux méthodes pour ajouter des marges aux codes-barres : utiliser SetMargins() avec un seul paramètre pour des marges uniformes sur tous les côtés, ou utiliser la méthode surchargée SetMargins() avec quatre paramètres pour définir des marges individuelles pour les côtés supérieur, droit, inférieur et gauche.

Qu'est-ce qu'une zone tranquille dans la terminologie des codes-barres ?

Une zone silencieuse est la zone vierge entourant un code-barres, également appelée marge. IronBarcode vous permet de configurer ces zones silencieuses à l'aide de la méthode SetMargins() afin que les scanners puissent distinguer le code-barres des autres éléments d'une étiquette.

Comment puis-je définir des marges uniformes sur tous les côtés d'un code-barres ?

Pour définir des marges uniformes sur tous les côtés, utilisez la méthode SetMargins() avec un seul paramètre entier représentant des pixels. Par exemple, barcode.SetMargins(50) ajoute une marge de 50 pixels aux quatre côtés lors de l'utilisation d'IronBarcode.

Puis-je définir des tailles de marge différentes pour chaque côté d'un code-barres ?

Oui, IronBarcode fournit une méthode SetMargins() surchargée qui accepte quatre paramètres (haut, droite, bas, gauche) pour définir des marges individuelles pour chaque côté du code-barres.

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

Les marges ou zones de silence sont essentielles pour une lecture fiable des codes-barres. Sans marges suffisantes, les scans peuvent échouer ou renvoyer des données incorrectes. IronBarcode vous aide à vous assurer que vos codes-barres sont scannés avec précision en fournissant des méthodes de configuration des marges faciles à mettre en œuvre.

Que se passe-t-il si je n'ajoute pas de marges à mes BarCodes ?

Sans marges appropriées, les scans de codes-barres peuvent échouer ou renvoyer des données incorrectes, ce qui est particulièrement problématique dans les environnements de logistique et de vente au détail. La méthode SetMargins() d'IronBarcode permet d'éviter ces problèmes en garantissant des zones de silence adéquates autour de vos codes-barres.

Comment enregistrer un BarCode avec des marges en tant qu'image ?

Après avoir défini les marges avec SetMargins(), vous pouvez enregistrer le code-barres à l'aide de la méthode SaveAsPng() d'IronBarcode ou d'autres méthodes de format comme SaveAsJpeg() ou SaveAsBmp().

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 2,002,059 | Version : 2025.12 vient de sortir