1. IronBarcode
  2. Anleitungen
  3. Barcode-Ränder festlegen

How to Add Margins to Barcodes

Curtis Chau
Curtis Chau
Aktualisiert:
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

Nutzen Sie IronBarcode heute kostenlos in Ihrem Projekt.

Erster Schritt:
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

Häufig gestellte Fragen

Was ist eine Ruhezone in Barcodes?

Die sogenannte Ruhezone oder der Rand ist der leere Bereich um einen Barcode herum. Er ist entscheidend dafür, dass Scanner den Barcode von anderen Elementen wie Text oder Grafiken unterscheiden können.

Warum sind Ränder beim Scannen von Barcodes wichtig?

Ränder verhindern Scanfehler und fehlerhafte Datenabfrage, indem sie eine klare Trennung zwischen Barcode und anderen Elementen gewährleisten. Dies ist insbesondere in der Logistik und im Einzelhandel von entscheidender Bedeutung, um Zeit- und finanzielle Verluste zu vermeiden.

Wie kann ich mit IronBarcode Ränder für Barcodes festlegen?

IronBarcode bietet eine unkomplizierte Methode namens „SetMargins“, mit der Sie Barcodes einheitliche oder individuelle Ränder zuweisen und so genaue Scans gewährleisten können.

Kann ich mit IronBarcode unterschiedliche Ränder für jede Seite eines Barcodes festlegen?

Ja, IronBarcode ermöglicht es Ihnen, individuelle Ränder für jede Seite festzulegen, indem Sie eine Überladung der Methode 'SetMargins' verwenden, die vier ganzzahlige Parameter für den oberen, rechten, unteren und linken Rand akzeptiert.

Welchen Vorteil bietet die Verwendung von IronBarcode zum Festlegen von Barcode-Rändern?

IronBarcode vereinfacht die Konfiguration der Barcode-Ränder und stellt sicher, dass diese für zuverlässiges Scannen jedes Mal korrekt eingestellt sind.

Wie kann ich mit IronBarcode die Ränder meiner Barcodes festlegen?

Laden Sie zunächst die IronBarcode C#-Bibliothek herunter, generieren Sie einen Barcode mit „CreateBarcode“ und legen Sie anschließend mit „SetMargins“ Ränder fest. Speichern Sie den Barcode abschließend als Bild mit „SaveAsPng“.

Welche Methode bietet IronBarcode an, um einen einheitlichen Rand auf einen Barcode anzuwenden?

IronBarcode bietet die Methode 'SetMargins' an, die eine einzelne Ganzzahl akzeptiert, um einen einheitlichen Rand um alle vier Seiten eines Barcodes anzuwenden.

Ist es mit IronBarcode möglich, einen Barcode mit Rändern als Bild zu speichern?

Ja, nachdem Sie die gewünschten Ränder eingestellt haben, können Sie den Barcode mit der Funktion „SaveAsPng“ in IronBarcode als Bild speichern.

Curtis Chau
Curtis Chau
  Jetzt mit dem Ingenieurteam chatten
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 1,935,276 | Version: 2025.11 gerade veröffentlicht