如何在 C# 中為條碼新增邊距

IronBarcode 提供了兩種在 C# 中為條碼添加邊距（靜默區）的方法：使用帶有單一參數的SetMargins()為所有邊距設定統一的邊距，或者使用帶有四個參數的重載SetMargins()為上、右、下、左邊分別設定邊距。

快速入門：在 C# 中為條碼新增邊距

1. 透過NuGet 套件管理器安裝 IronBarcode
2. 使用BarcodeWriter.CreateBarcode()建立條碼
3. 使用SetMargins(100)設定統一邊距，即所有邊距均為 100 像素。
4. 或使用SetMargins(top, right, bottom, left)設定各個邊距。
5. 使用SaveAsPng()或其他格式方法儲存結果

```cs {.cs .numberLines startFrom="1"} :title=快速入門 // 快速範例 - 統一的 50px 邊距 var barcode = BarcodeWriter.CreateBarcode("Hello World", BarcodeWriterEncoding.QRCode); 條碼.設定邊距(50); barcode.SaveAsPng("barcode-with-margin.png");

條碼要可靠，需要的不只是條紋和空格。 程式碼周圍的空白區域，稱為"靜默區"或邊距，同樣至關重要。 這個靜默區使掃描器能夠將條碼與標籤上的其他元素（如文字或圖形）區分開來。

如果沒有足夠的餘量，掃描可能會失敗或傳回錯誤資料。 這在物流和零售業尤其重要，因為掃描失敗會導致大量的時間和經濟損失。 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>

<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>

## 如何設定統一的邊距？

<!-- TODO: Add image here -->
<!-- ![Diagram illustrating set margins on all sides implementation](/static-assets/images/TODO/set-margins-on-all-sides-code_illustration.webp) -->
<!-- Description: Diagram or screenshot illustrating the code concept -->

確保適當安靜區域的最簡單方法是使用`SetMargins`方法。 此方法接受一個整數，表示要新增到條碼所有四個邊的空白邊框的像素數。 這種方法在[建立需要保持一致間距的二維碼](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 像素的均勻正方形邊距。 這樣就形成了一個最佳的靜音區，確保在不同的條碼讀取場景下都能可靠地進行掃描。

如何為每一邊設定不同的邊距？

除了套用統一邊距外，IronBarcode 還允許您使用SetMargins方法的重載為每一邊指定單獨的邊距。 此重載接受四個整數參數，分別表示上邊距、右邊距、下邊距和左邊距。 這種靈活性在建立條碼為 PDF 格式時尤其重要，因為精確的佈局控制至關重要。

在以下範例中，我們定義了具體的邊距：頂部和底部為 10 像素，左側和右側為 5 像素。 這種不對稱邊距配置在將條碼整合到現有文件佈局中或使用自訂條碼樣式時非常有用。

: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");

$vbLabelText   $csharpLabel

如果採用個體利潤率，輸出結果會是什麼樣的？

什麼時候應該為每一邊使用不同的邊距？

在將條碼整合到具有特定佈局限制的現有標籤設計中時，不同的邊距非常有用。 例如，您可能需要最小的頂部/底部邊距以適應高度限制，同時保持更寬的左側/右側邊距以適應掃描器的接近角度。 該技術通常與其他條碼產生功能相結合，以創建專業級的條碼解決方案。

在以下情況下，個體利潤控制尤其重要：

• 在間距要求嚴格的文件中嵌入條碼
• 建立必須符合業界特定標準的標籤
• 針對特定掃描器類型或方向最佳化條碼放置位置
• 與現有印刷佈局整合，尤其是在空間有限的情況下

常見的邊距尺寸指南是什麼？

業界標準通常建議線性條碼的最小靜音區寬度為最窄條寬（X 尺寸）的 10 倍，二維條碼（如 QR 碼）的最小靜音區寬度至少為模組寬度的 4 倍。 然而，較大的裕量通常會提高掃描可靠性，尤其是在具有挑戰性的條件下。

實際操作中，請參考以下指導原則： -二維碼：所有邊至少佔用 4 個模組寬度 -代碼 128 ：最小靜音區 10 倍（窄條寬度的 10 倍）

• PDF417 ：所有邊至少為模組寬度的 2 個單位 -資料矩陣：所有邊的最小寬度均為 1 個模組寬度

這些標準確保與各種掃描設備和環境條件相容。 如有疑問，請使用較大的邊距以最大限度地提高掃描成功率。

IronBarcode 中的邊距設定與其他功能（如糾錯設定）無縫集成，從而創建強大的條碼解決方案，在實際應用中可靠運作。