如何在 C# 中为 BarCode 添加页边距;

IronBarcode 提供了两种在 C# 中为条形码添加边距（静音区）的方法：使用 SetMargins() 并带有单个参数以在所有边上设置统一的边距；或者使用带有四个参数的重载 SetMargins() 为顶部、右侧、底部和左侧设置单独的边距。

as-heading:2（快速入门：在 C# 中为 BarCode 添加边距）

1.通过NuGet软件包管理器安装 IronBarcode 2.使用 BarcodeWriter.CreateBarcode() 创建您的条形码 3.使用 SetMargins(100) 在所有边上应用统一的页边距 100px 4.或使用 SetMargins(top, right, bottom, left) 设置单个页边距 5.使用 SaveAsPng() 或其他格式方法保存结果

```cs {.cs .numberLines startFrom="1"} :title=Quickstart // 快速示例 - 统一的 50px 页边距 var barcode = BarcodeWriter.CreateBarcode("Hello World", BarcodeWriterEncoding.QRCode)； BarCode.SetMargins(50)； barcode.SaveAsPng("barcode-with-margin.png")；

条形码要想可靠，需要的不仅仅是条和空格。 代码周围的空白区域，即所谓的 "安静区域 "或边距（margin），同样至关重要。 静区使扫描仪能够将条形码与标签上的其他元素（如文本或图形）区分开来。

如果没有足够的余量，扫描可能会失败或返回不正确的数据。 这一点在物流和零售业尤为重要，因为扫描失败会导致重大的时间和经济损失。 IronBarcode 中[支持的条码格式](https://ironsoftware.com/csharp/barcode/get-started/supported-barcode-formats/)都有特定的边距要求，以确保最佳的扫描性能。

IronBarcode 提供了配置这些边距的直接方法，确保您的条形码每次都能准确扫描。这些边距设置可与所有[条码图像生成](https://ironsoftware.com/csharp/barcode/how-to/create-barcode-images/)功能无缝配合。 在本指南中，我们将探讨 IronBarcode 提供的设置条码边距的方法。

<h3>开始使用 IronBarcode</h3>

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

	

		
第一步：
		

			

		
        
		
免费开始
	



<hr>

<div class="hsg-featured-snippet">
    <h2>如何在 C# 中为条形码添加边距</h2>
    <ol>
        <li><a class="js-modal-open" data-modal-id="trial-license-after-download" href="https://www.nuget.org/packages/BarCode/">下载 IronBarcode C# 库，为条形码添加边距。</a></li>
        <li>使用<code>CreateBarcode</code>生成带有字符串值的条形码 </li>
        <li>使用<code>SetMargins</code>为所有四个边应用统一的静区。</li> 
        <li>使用<code>SetMargins</code>为条形码的每一边添加边距</li>
        <li>使用<code>SaveAsPng</code>将条形码另存为图像。</li>
    </ol>
</div>

<hr>

<h2>如何在所有边上设置统一的边距？

<! -- 待办事项：在此处添加图片 -->
<! -- ![四边设置边距实现示意图](/static-assets/images/TODO/set-margins-on-all-sides-code_illustration.webp) --> -->
<！--说明：说明代码概念的图表或截图 -->

确保适当安静区域的最简单方法是使用 `SetMargins` 方法。 此方法接受一个整数，表示要添加到条形码所有四个边的空白边框的像素数。 这种方法在[创建 QR 码](https://ironsoftware.com/csharp/barcode/examples/csharp-create-qr-code/)或其他需要一致间距的二维条形码格式时特别有用。

在本例中，我们创建了一个条形码，将边距设置为 100 像素，并使用 `SaveAsPng` 保存结果。 页边距设置可与其他[条形码样式选项](https://ironsoftware.com/csharp/barcode/how-to/customize-barcode-style/)相结合，实现全面定制。

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

使用统一页边距时的输出是什么样的？

如输出所示，在条形码周围应用了 100 像素的统一方形边距。 这就创造了一个最佳的安静区域，确保在不同的[条码阅读场景](https://ironsoftware.com/csharp/barcode/tutorials/reading-barcodes/)中进行可靠的扫描。

为什么统一页边距对扫描很重要？ 统一的页边距可确保各面的静区保持一致，这对于零售环境中常用的全向扫描仪来说至关重要。 一致的静区可防止部分读取和将相邻图形或文本误解为条形码数据的一部分。 在处理[不完善的条形码和图像校正](https://ironsoftware.com/csharp/barcode/examples/imperfect-barcode-with-image-correction/)情况时，这一点变得尤为重要。 在为专业应用生成条形码时，适当的页边距有助于提高条形码系统的整体[容错性](https://ironsoftware.com/csharp/barcode/features/fault-tolerance/)。 即使在扫描条件不太理想的情况下，边距也能起到缓冲区的作用，帮助扫描仪清楚地识别条形码的开始和结束位置。

如何为每一面设置不同的边距？ 除了应用统一页边距外，IronBarcode 还允许您使用 `SetMargins` 方法的重载为每一面指定单独的页边距。 此重载接受四个整数参数，分别表示上边距、右边距、下边距和左边距。 在[将条形码创建为 PDF](https://ironsoftware.com/csharp/barcode/how-to/create-barcode-as-pdf/) 时，这种灵活性尤为重要，因为在这种情况下，精确的布局控制至关重要。 在以下示例中，我们定义了具体的边距：顶部和底部为 10 像素，左侧和右侧为 5 像素。 在将条形码集成到现有文档布局中或使用 [ 自定义条形码样式](https://ironsoftware.com/csharp/barcode/examples/csharp-custom-barcode/)时，这种非对称页边距配置非常有用。 ```cs :path=/static-assets/barcode/content-code-examples/how-to/setting-multiple-margin.cs ```

带有单独页边距的输出是什么样的？

什么情况下我应该在每一面使用不同的页边距？ 在将条形码整合到具有特定布局限制的现有标签设计中时，不同的页边距非常有用。 例如，您可能需要最小的上/下边距以适应高度限制，同时保持较宽的左/右边距以适应扫描仪的接近角度。 这种技术通常与其他[条码生成功能](https://ironsoftware.com/csharp/barcode/features/generate/)相结合，以创建专业级条码解决方案。 当出现以下情况时，对单个页边距的控制就显得尤为重要： - 在间距要求紧凑的文档中嵌入 BarCode - 创建必须符合特定行业标准的标签 - 针对特定扫描仪类型或方向优化条形码位置 - 与空间有限的现有印刷布局相结合

常见的页边距大小准则是什么？ 行业标准通常建议线性条码的最小静区宽度为最窄条码宽度（X 维）的 10 倍，QR 等二维码的最小静区宽度至少为 4 个模块。 然而，较大的余量通常会提高扫描的可靠性，尤其是在具有挑战性的条件下。 在实际执行过程中，请参考以下指导原则： - **QR 代码**：四边至少有 4 个模块宽度 - **代码 128**：最小 10 倍静区（窄条宽度的 10 倍） - **PDF417**：四边至少有 2 个模块宽度 - **数据矩阵**：四边最小宽度为 1 个模块 这些标准确保了与各种扫描设备和环境条件的兼容性。 如有疑问，请使用较大的边距，以最大限度地提高扫描成功率。 IronBarcode 中的边距设置可与 [ 错误纠正设置](https://ironsoftware.com/csharp/barcode/how-to/error-correction/)等其他功能无缝集成，从而创建在实际应用中性能可靠的强大条形码解决方案。