1. IronBarcode
  2. 操作指南
  3. 设置条形码边距

How to Add Margins to Barcodes

Curtis Chau
Curtis Chau
已更新:
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

今天在您的项目中使用 IronBarcode，免费试用。

第一步：
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

常见问题解答

条形码中的静默区是什么？

静区（或称边距）是指条形码周围的空白区域。它对于帮助扫描器将条形码与其他元素（例如文本或图形）区分开来至关重要。

为什么边距对条形码扫描很重要？

留白可以清晰地区分条形码和其他元素，从而防止扫描失败和数据检索错误。这在物流和零售行业尤为重要，可以避免时间和经济损失。

如何使用 IronBarcode 设置条形码的边距？

IronBarcode 提供了一种名为“SetMargins”的简单方法，允许您为条形码应用统一或个性化的边距，从而确保扫描准确。

我可以使用 IronBarcode 为条形码的每一边设置不同的边距吗？

是的，IronBarcode 允许您使用“SetMargins”方法的重载来指定每一侧的单独边距，该方法接受四个整数参数，分别表示上边距、右边距、下边距和左边距。

使用 IronBarcode 设置条形码边距有什么好处？

IronBarcode 简化了条形码边距的配置过程，确保每次都能正确设置边距，从而实现可靠的扫描。

我该如何开始使用 IronBarcode 来设置条形码的边距？

首先下载 IronBarcode C# 库，使用“CreateBarcode”生成条形码，然后使用“SetMargins”应用边距。最后，使用“SaveAsPng”将条形码保存为图像。

IronBarcode 提供了哪种方法来为条形码应用统一边距？

IronBarcode 提供了“SetMargins”方法，该方法接受一个整数，用于在条形码的四个边上应用统一的边距。

是否可以使用 IronBarcode 将带有边距的条形码保存为图像？

是的，设置好所需的边距后，您可以使用 IronBarcode 中的“SaveAsPng”功能将条形码保存为图像。

Curtis Chau
Curtis Chau
  立即与工程团队聊天
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外，Curtis 对物联网 (IoT) 有浓厚的兴趣，探索将硬件和软件集成的新方法。在空闲时间，他喜欢玩游戏和构建 Discord 机器人，将他对技术的热爱与创造力相结合。

准备开始了吗？
Nuget 下载 1,935,276 | 版本: 2025.11 刚刚发布