1. IronBarCode
  2. 操作指南
  3. 設置條碼邊距

如何在 C# 中為 BarCode 添加邊距

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

IronBarcode 提供兩種在 C# 中為 BarCode 添加邊距（靜區）的方法：使用帶有單一參數的 SetMargins() 來設定所有邊緣的統一邊距，或使用帶有四個參數的重載版本 SetMargins() 來分別設定頂部、右側、底部和左側的邊距。

要讓BarCode具備可靠性，僅靠BarCode和空格是不夠的。 包圍程式碼的空白區域，俗稱"靜區"或邊距，同樣至關重要。 此靜區可讓掃描器將BARCODE與標籤上的其他元素（例如文字或圖形）區分開來。

若邊距不足，掃描可能會失敗或返回錯誤資料。 這在物流和零售領域尤為重要，因為掃描失敗會導致重大時間與金錢損失。 IronBarcode 支援的各種 BarCode 格式各有特定的邊距要求，以確保最佳的掃描效能。

IronBarcode 提供直觀的方法來設定這些邊距，確保您的 BarCode 每次都能精準掃描。這些邊距設定可與所有 BarCode 圖像生成功能無縫整合。 在本指南中，我們將探討 IronBarcode 提供的 BarCode 邊距設定方法。

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

使用 IronBarcode 的 SetMargins() 方法，僅需一行程式碼即可在任何 BarCode 周圍添加靜區。 立即開始操作——建立BARCODE、設定邊距，並儲存您的圖像檔案。

  1. using 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# 中為 BarCode 添加邊距

  1. 下載 IronBarcode C# 程式庫，為 BarCode 添加邊距
  2. 使用 CreateBarcode 根據字串值產生 BARCODE
  3. 使用 SetMargins 為四個邊緣設定統一的留白區域
  4. 使用 SetMargins 為 BarCode 的每一側設定邊距
  5. 使用 SaveAsPng 將 BarCode 儲存為圖片

如何設定所有邊緣的統一邊距？

確保適當靜音區的最簡單方法是使用 SetMargins 方法。 此方法接受一個整數參數，該數值代表要在BARCODE四邊添加作為空白邊框的像素數。 此方法在製作 QR 碼或其他需要保持間距一致的 2D BARCODE 格式時特別有用。

在此範例中，我們建立一個 BARCODE，將邊距設定為 100 像素，並使用 SaveAsPng 儲存結果。 邊距設定可與其他BarCode樣式選項結合使用，以實現全面的自訂。

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

' Create a QR code
Dim qrcode As GeneratedBarcode = 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

設定統一邊距後的輸出效果為何？

四邊均帶有白色邊距的 QR 碼，BarCode 元素周圍間距適當

如輸出所示，BARCODE 周圍已套用 100 像素的均勻方形邊距。 這能創造出最佳的靜音區，確保在各種BarCode讀取情境下皆能進行可靠的掃描。

為何掃描時保持統一的邊距很重要？

統一的邊距可確保各邊留白區域保持一致，這對於零售環境中常見的全向掃描器至關重要。 一致的靜區可防止部分讀取，並避免將相鄰的圖形或文字誤判為BarCode數據的一部分。 在處理不完整的BarCode及影像校正情境時，這一點尤為重要。

在為專業應用生成BarCode時，適當的邊距有助於提升BarCode系統的整體容錯能力。 邊距作為緩衝區，有助於掃描器即使在非理想的掃描條件下，也能清楚辨識BarCode的起始與結束位置。

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

除了套用統一的邊距外，IronBarcode 還允許您透過 SetMargins 方法的重載，為每一邊指定個別的邊距。 此重載接受四個整數參數，分別代表頂部、右側、底部和左側邊距。 這種靈活性在將 BARCODE 輸出為 PDF 時尤為重要，因為此時精確的版面配置控制至關重要。

在以下範例中，我們定義了具體的邊距：上下邊距為 10 像素，左右邊距為 5 像素。 此非對稱邊距設定在將BarCode整合至現有文件版面配置，或處理自訂BarCode樣式時特別實用。

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

' Create a QR code
Dim qrcode As GeneratedBarcode = 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

啟用個別邊距時，輸出效果會是什麼樣子？

展示定位標記與數據矩陣周圍邊距間距的 QR 碼範例

何時應為每邊設定不同的邊距？

當需將BARCODE整合至具有特定版面限制的現有標籤設計中時，採用不同的邊距設定將有助於調整版面。 例如，您可能需要將上下邊距縮至最小以符合高度限制，同時保留較寬的左右邊距以適應掃描器的掃描角度。 此技術常與其他BarCode生成功能結合，以打造專業級的BarCode解決方案。

在以下情況下，個別邊距的控制尤為重要：

  • 在具有嚴格間距要求的文件中嵌入 BARCODE
  • 建立標籤時必須符合特定產業標準
  • 針對特定掃描器類型或方向優化BARCODE位置
  • 整合至空間極為有限的現有列印版面

常見的邊距大小規範有哪些？

業界標準通常建議，線性BarCode的最小靜區應為最窄BarCode寬度（X 維度）的 10 倍，而 QR 碼等二維BarCode則至少需 4 個模組寬度。 然而，較大的邊距通常能提高掃描的可靠性，特別是在艱難的環境下。

在實際翻譯時，請參考以下指引：

  • QR 碼：所有邊緣需至少保留 4 個模組寬度
  • Code 128：靜區寬度至少為 10X（即窄條寬度的 10 倍）
  • PDF417：所有邊緣至少需保留 2 個模組寬度
  • 數據矩陣：所有邊緣至少保留 1 模組寬度

這些標準可確保與各種掃描設備及環境條件的相容性。 如有疑慮，請使用較大的邊距以最大化掃描成功率。

IronBarcode 中的邊距設定能與錯誤修正設定等其他功能無縫整合，從而打造出在實際應用中表現可靠的強大 BarCode 解決方案。

常見問題

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

IronBarcode 提供兩種方法來為條碼新增邊距：使用 SetMargins() 的單一參數來為所有邊設置均勻的邊距，或使用四個參數的重載 SetMargins() 來為上、右、下、左各邊設定個別邊距。

在條碼術語中，什麼是靜區？

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

如何在條碼的所有邊設置均勻的邊距？

要在所有邊設置均勻的邊距，請使用 SetMargins() 方法並傳入單個整數參數以代表像素。例如，使用 IronBarcode 時，barcode.SetMargins(50) 在所有四個邊新增 50 像素的邊距。

我可以為條碼的每個邊設置不同的邊距大小嗎？

是的，IronBarcode 提供了一個重載的 SetMargins() 方法，它接受四個參數（上、右、下、左），以便為條碼的每個邊設置個別的邊距。

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

邊距或靜區對於可靠的條碼掃描至關重要。如果邊距不足，掃描可能會失敗或返回錯誤的數據。IronBarcode 通過提供簡單的邊距配置方法來幫助確保您的條碼精確地進行掃描。

如果我不為我的條碼新增邊距會怎樣？

如果沒有適當的邊距，條碼掃描可能會失敗或返回錯誤的數據，這在物流和零售環境中特別麻煩。IronBarcode 的 SetMargins() 方法有助於防止這些問題，確保條碼周圍有足夠的靜區。

如何將帶有邊距的條碼儲存為圖像？

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

IronBarcode如何幫助改善業務流程效率？

IronBarcode通過使條碼生成和讀取快速且準確來提高業務流程效率，減少手動數據輸入錯誤，並改善庫存和資產追蹤。

將IronBarcode實現於專案中需要什麼程式設計技能？

基本的C#程式設計知識足以將IronBarcode實現於專案中，因為它提供了簡單的方法和全面的文檔來指導開發者。

IronBarcode適合於小型專案和大型企業應用嗎？

IronBarcode設計為可擴展且多功能，使其適合小型專案和需要強大條碼解決方案的大型企業應用。

Curtis Chau
Curtis Chau
  立即與工程團隊聯繫
技術撰稿人

Curtis Chau 擁有卡爾頓大學（Carleton University）的電腦科學學士學位，專精於前端開發，並精通 Node.js、TypeScript、JavaScript 及 React。他熱衷於打造直觀且美觀的用戶介面，喜歡運用現代框架，並創建結構完善、視覺上吸引人的手冊。

除了開發工作之外，Curtis 對物聯網（IoT）抱有濃厚興趣，致力於探索整合硬體與軟體的創新方法。閒暇時，他喜歡玩遊戲和開發 Discord 機器人，將對科技的熱愛與創意相結合。

準備好開始了嗎？
Nuget 下載 2,240,258 | 版本： 2026.5 just released
Still Scrolling Icon

還在捲動嗎？

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