1. IronBarcode
  2. 使用說明
  3. 設定條碼邊距

如何在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方法。 此方法接受一個整數，表示在條碼所有四邊增加空白邊框的像素數。 當建立QR碼或其他需要一致間距的2D條碼格式時，此方法特別有用。

在此範例中，我們建立一個條碼，將邊距設為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");
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碼在四邊應用白色邊距，顯示條碼元素周圍適當的間距

如輸出所示，已在條碼周圍應用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");
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碼範例展示定位標記和資料矩陣周圍的邊距間距

什麼時候應該使用不同的側邊邊距？

當將條碼整合到具有特定佈局限制的現有標籤設計中時，不同的邊距非常有用。 例如，為了適應高度限制，可能需要最小的頂部/底部邊距，同時保持較寬的左/右邊距以適應掃描器的進入角。 此技術常與其他條碼生成特性結合使用，以建立專業級的條碼解決方案。

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

  • 將條碼嵌入空間要求緊張的文件中
  • 建立必須符合行業標準的標籤
  • 優化條碼在特定掃描器型別或方向上的擺放
  • 與空間有限的現有列印佈局整合

一般的邊距尺寸指南是什麼？

行業標準通常建議線性條碼的靜區至少為最窄條（X維度）寬度的10倍，或QR等2D碼至少為4個模塊寬度。 然而，較大的邊距通常會改善在挑戰環境中的掃描可靠性。

在實際實施中，請考慮以下指南：

  • QR碼：所有側面至少4個模塊寬度
  • Code 128：最小10X靜區（最窄條寬度的10倍）
  • PDF417：所有側面至少2個模塊寬度
  • Data Matrix：所有側面至少1個模塊寬度

這些標準確保與各種掃描裝置和環境條件的相容性。 當不確定時，使用較大的邊距以最大化掃描成功率。

IronBarcode中的邊距設置與錯誤校正設置等其他功能無縫整合，以建立在實際應用中可靠執行的強大條碼解決方案。

常見問題

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

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

條碼術語中的留白區域是什麼？

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

如何設置條碼四周的統一邊距？

要設置所有側面的統一邊距，使用SetMargins()方法並傳遞單一整數參數來表示像素。例如，使用IronBarcode的barcode.SetMargins(50)將在四個側面新增50像素的邊距。

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

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

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

邊距或留白區域對於可靠的條碼掃描至關重要。沒有足夠的邊距，掃描可能會失敗或返回錯誤資料。IronBarcode通過提供簡單的邊距配置方法幫助確保您的條碼準確掃描。

如果我不給條碼新增邊距會怎麼樣？

沒有適當的邊距，條碼掃描可能會失敗或返回錯誤資料，這在物流和零售環境中特別成問題。IronBarcode的SetMargins()方法通過確保條碼周圍有足夠的留白區域來幫助防止這些問題。

如何將包含邊距的條碼保存為圖像？

設置邊距後，您可以使用IronBarcode的SaveAsPng()方法或其他格式方法如SaveAsJpeg()或SaveAsBmp()來保存條碼。

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

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

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

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

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

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

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

Curtis Chau擁有Carleton大學的電腦科學學士學位，專精於前端開發，擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面，喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

除了開發，Curtis對物聯網（IoT）有濃厚的興趣，探索創新的方法來整合硬體和軟體。在空閒時間，他喜歡玩遊戲和建立Discord機器人，結合他對技術的熱愛與創造力。

準備好開始了嗎？
Nuget 下載 2,331,688 | 版本： 2026.7 剛剛發布
Still Scrolling Icon

還在滾動嗎？

想快速驗證嗎？ PM > Install-Package BarCode
運行範例觀看您的字串成為條碼。