1. IronBarcode
  2. 操作指南
  3. 設定 BarCode 邊界

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

Curtis Chau
Curtis Chau
更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

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

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

如果沒有足夠的餘量，掃描可能會失敗或傳回錯誤資料。 這在物流和零售業尤其重要，因為掃描失敗會導致大量的時間和經濟損失。 IronBarcode支援的條碼格式各有特定的邊距要求，以確保最佳的掃描效能。

IronBarcode提供簡單的方法來配置這些邊距，確保條碼每次都能準確掃描。這些邊距設定與所有條碼影像產生功能無縫協作。 在本指南中，我們將探討IronBarcode提供的設定條碼邊距的方法。

快速入門：在 C# 中為條碼添加邊距

使用 IronBarcode 的 SetMargins() 方法，可以在一行程式碼中為任何條碼新增靜默區。 立即開始—建立條碼、套用邊距並儲存影像檔案。

  1. 使用NuGet套件管理器安裝https://www.nuget.org/packages/BarCode

    PM > Install-Package BarCode

  2. 複製並運行這段程式碼。

    IronBarCode.BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode, 250, 250).SetMargins(50).SaveAsPng("barcode-with-margin.png");

  3. 部署到您的生產環境進行測試

    今天就在您的專案中開始使用免費試用IronBarcode

    arrow pointer

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

  1. 下載IronBarcode C# 函式庫，為條碼新增邊距。
  2. 使用`CreateBarcode`產生帶有字串值的條碼
  3. 使用`SetMargins`為所有四個邊應用統一的靜區。
  4. 使用`SetMargins`為條碼的每一邊加上邊距
  5. 使用`SaveAsPng`將條碼另存為影像。

如何設定統一的邊距？

確保適當安靜區域的最簡單方法是使用 SetMargins 方法。 此方法接受一個整數，表示要新增到條碼所有四個邊的空白邊框的像素數。 這種方法在建立需要保持一致間距的二維碼或其他二維條碼格式時特別有用。

在這個範例中，我們建立了一個條碼，將邊距設為 100 像素，並使用 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");
$vbLabelText   $csharpLabel

採用均勻邊距時，輸出結果會是什麼樣子？

二維碼四周均留有白色邊距，條碼元素之間保持適當的間距。

如圖所示，條碼周圍應用了 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中的邊距設定與其他功能（如糾錯設定）無縫集成，從而創建強大的條碼解決方案，在實際應用中可靠運作。

常見問題解答

如何在 C# 中為 BarCode 加入頁邊？

IronBarcode 提供了兩種方法來為 BarCode 加入邊距：使用 SetMargins() 搭配單一參數來設定所有邊緣的均勻邊距，或使用重載的 SetMargins() 搭配四個參數來設定上邊、右邊、下邊和左邊的個別邊距。

在 BarCode 術語裡，什麼是靜區？

靜區是條碼周圍的空白區域，也稱為邊界。IronBarcode 允許您使用 SetMargins() 方法配置這些靜音區，以確保掃描器能夠將條碼與標籤上的其他元素區分開來。

如何在 BarCode 的各個面上設定統一的邊距？

若要設定各邊的均勻邊距，請使用 SetMargins() 方法，並使用代表像素的單一整數參數。例如，當使用 IronBarcode 時，barcode.SetMargins(50) 會在四邊都加上 50 像素的邊距。

我可以為 BarCode 的每一面設定不同的邊距大小嗎？

是的，IronBarcode 提供了一個重載的 SetMargins() 方法，它接受四個參數 (上、右、下、左) 來為條碼的每一面設定獨立的邊距。

為什麼邊距對於 BarCode 掃描很重要？

邊界或安靜區對於可靠的 BarCode 掃描是至關重要的。如果沒有足夠的邊界，掃描可能會失敗或返回不正確的資料。IronBarcode 提供簡易的邊界配置方法，有助於確保您的條碼掃描準確無誤。

如果我沒有在我的 BarCode 上加上頁邊，會發生什麼事？

如果沒有適當的邊距，條碼掃描可能會失敗或傳回不正確的資料，在物流和零售環境中問題尤其嚴重。IronBarcode 的 SetMargins() 方法可確保您的條碼周圍有足夠的安靜區，從而有助於避免這些問題。

如何將帶有邊距的 BarCode 儲存為影像？

使用 SetMargins() 設定頁邊後，您可以使用 IronBarcode 的 SaveAsPng() 方法或其他格式方法（如 SaveAsJpeg() 或 SaveAsBmp() ）儲存條碼。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位，專注於前端開發，擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面，喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 有著濃厚的興趣，探索將硬體和軟體結合的創新方式。在閒暇時間，他喜愛遊戲並構建 Discord 機器人，結合科技與創意的樂趣。

準備好開始了嗎？
Nuget 下載 2,121,847 | 版本： 2026.3 剛剛發布
Still Scrolling Icon

還在捲動嗎？

想要快速證明？ PM > Install-Package BarCode
執行範例 看您的字串變成 BarCode。