1. IronBarcode
  2. 操作指南
  3. .NET 作為圖像創建條碼
如何在 C# 中創建條碼和 QR 代碼圖像

如何在 C# 中使用 IronBarcode 創建條碼圖像。

Hairil Hasyimi Bin Omar
Hairil Hasyimi Bin Omar
更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronBarcode 使 .NET 開發人員只需一行代碼即可在 C# 中生成條碼和 QR 代碼圖像，並支援多種格式和圖像類型。使用強大的 API 建立庫存管理系統、零售應用程式或文件處理解決方案，該 API 可建立專業品質的條碼，以便在所有主要讀取器上進行可靠的掃描。

快速入門：一行建立並儲存 Code128 條碼

使用 IronBarcode 的單行 API 從字串中建立 Code128 條碼，並將其儲存為 PNG 影像。 立即開始 - 提供資料、選擇編碼和大小，並撰寫您的影像檔案。

Nuget Icon立即開始使用 NuGet 建立 PDF 檔案：

  1. 使用 NuGet 套件管理器安裝 IronBarcode

    PM > Install-Package BarCode

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

    IronBarCode.BarcodeWriter.CreateBarcode("Sample123", BarcodeEncoding.Code128, 250, 100).SaveAsPng("Barcode.png");

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

    立即開始在您的專案中使用 IronBarcode，免費試用！
    arrow pointer
### 最小工作流程（5 個步驟）
  1. 下載 C# IronBarcode 函式庫
  2. 生成條碼並儲存為圖像文件
  3. 產生二維碼並儲存為圖像文件

如何產生 BarCode 並儲存為影像檔？

除了讀取條碼之外，IronBarcode 還允許使用者用最少的編碼來編寫條碼。 Call the CreateBarcode() method from the BarcodeWriter class, specifying the barcode value, type, width, and height in the method parameters. 這會輸出一個 GeneratedBarcode 物件，可使用 SaveAs() 方法將其儲存為影像檔案。

我可以將哪些類型的資料用於 BarCode 值？

BarcodeWriter.CreateBarcode() 方法接受條碼值的多種資料類型：byte[]陣列、MemoryStream和字串。 字串長度和可接受的字元因 BarCode 類型而異，詳情請參閱我們的 API 文件。 Code128 支援完整的 ASCII 字元集，而 UPC-A 則需要準確的 12 位數字。 對於二進位資料，請使用 byte[] array 來編碼複雜的資料結構。

支援哪些 BarCode 編碼類型？

IronBarcode 支援多種條碼格式-請參閱我們的 Supported Barcode Formats 文章以取得完整清單。受歡迎的格式包括

  • Linear/1D BarCode：Code128、Code39、UPC-A、UPC-E、EAN-8、EAN-13
  • 2D BarCode：QR Code、Data Matrix、PDF417、Aztec
  • 專業格式：用於運輸的 MaxiCode、用於零售的 Databar

每種格式都有其特定用途。 Code128 可以很好地處理一般的字母數字資料，而 QR 編碼則提供優異的錯誤修正功能，適用於行動掃描。

寬度和高度設定如何影響我的 BarCode？

以像素為單位設定輸出 BarCode 影像的尺寸。 兩者的預設尺寸均為 250 px。 某些 BarCode 類型 (QR、PDF417) 需要特定尺寸以符合規範。 當輸入的尺寸與要求不符時，Barcode 會以符合要求的尺寸產生，並以空白填滿剩餘的空間。 尺寸太小會出現異常。

為了達到最佳掃描效果：

  • 線性 BarCode：保持寬度明顯大於高度
  • 二維條碼：使用方形尺寸的 QR 代碼（例如 250x250）
  • 列印品質：較高的像素尺寸可改善較大的實體尺寸的列印品質

我可以將 BarCode 匯出成哪些影像格式？

來自 BarcodeWriter.CreateBarcode() 的 GeneratedBarcode 物件會使用特定的 SaveAs() 方法儲存為各種影像格式：

  • SaveAsGif(): 儲存為 GIF 圖檔。
  • SaveAsJpeg(): 儲存為 JPEG 影像檔案。
  • SaveAsPng(): 儲存為 PNG 圖檔 (建議用於網頁)
  • SaveAsTiff(): 儲存為 TIFF影像檔案 (非常適合存檔/列印)
  • SaveAsWindowsBitmap(): 儲存為 BMP影像檔案。
  • SaveAsImage()：一般方法-在檔案路徑中指定格式副檔名

此外，將條碼匯出為串流以進行記憶體內處理，或將條碼建立為 PDF 文件以進行文件整合。

如何生成 BarCode 並將其儲存為圖像檔案？

使用 BarcodeWriter.CreateBarcode() 來建立 Code128 條碼，並將其儲存為 JPEG 影像：

using IronBarCode;

// Create a basic barcode
BarcodeWriter.CreateBarcode("IronBarcode123", BarcodeEncoding.Code128, 200, 100).SaveAsJpeg("OneDBarcode.jpeg");

// Create a barcode with custom options
var myBarcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128, 300, 150);

// Apply styling
myBarcode.AddBarcodeValueTextBelowBarcode();
myBarcode.SetMargins(10);

// Save in multiple formats
myBarcode.SaveAsJpeg("product-barcode.jpg");
myBarcode.SaveAsPng("product-barcode.png");
using IronBarCode;

// Create a basic barcode
BarcodeWriter.CreateBarcode("IronBarcode123", BarcodeEncoding.Code128, 200, 100).SaveAsJpeg("OneDBarcode.jpeg");

// Create a barcode with custom options
var myBarcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128, 300, 150);

// Apply styling
myBarcode.AddBarcodeValueTextBelowBarcode();
myBarcode.SetMargins(10);

// Save in multiple formats
myBarcode.SaveAsJpeg("product-barcode.jpg");
myBarcode.SaveAsPng("product-barcode.png");
Imports IronBarCode

' Create a basic barcode
BarcodeWriter.CreateBarcode("IronBarcode123", BarcodeEncoding.Code128, 200, 100).SaveAsJpeg("OneDBarcode.jpeg")

' Create a barcode with custom options
Dim myBarcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128, 300, 150)

' Apply styling
myBarcode.AddBarcodeValueTextBelowBarcode()
myBarcode.SetMargins(10)

' Save in multiple formats
myBarcode.SaveAsJpeg("product-barcode.jpg")
myBarcode.SaveAsPng("product-barcode.png")
$vbLabelText   $csharpLabel
生成的一維條碼，帶有黑色垂直條，顯示條碼創建代碼的示例輸出

如需進階樣式選項，請參閱我們的 自訂 BarCode 樣式指南。

如何產生 QR 碼並儲存為影像檔？

QR 碼，歸類為二維條碼，IronBarcode 完全支援。 從餐廳菜單到付款系統，它們的多功能性、外觀吸引力以及可客製化的功能已被廣泛採用。

由於 QR 代碼的複雜性，製作 QR 代碼需要不同的方法。 呼叫 QRCodeWriter 類中的 CreateQrCode() 方法，該方法接受 4 個參數：條碼值、輸出 QR 碼大小、QRCodeWriter.QrErrorCorrectionLevel 枚舉欄位，以及 QRVersion 。

QR 碼值可以使用哪些資料類型？

QRCodeWriter.CreateQrCode() 以 byte[] array、MemoryStream 或 System.String 類型接受數值、字母或字母數字值。QR 碼擅長於儲存：

  • URLs：將使用者引導至網站或登陸頁面
  • 文字：最多可儲存 4,296 個字母數字字符
  • 二進位資料：編碼檔案或複雜的資料結構
  • 結構化資料：VCard、WiFi 認證或付款資訊

關於 Unicode 支援和國際字元，請參閱我們的 撰寫 Unicode BarCode 教學。

如何設定 QR 碼大小？

以 pixels (px) 為單位，直接指定 QR 碼大小為 Int32 類型。 預設大小為 500 px。 請考慮以下因素：

  • 顯示媒介：螢幕顯示通常需要 200-400px
  • 列印應用程式：請使用 600px 或更高的尺寸，以獲得高品質的列印效果
  • 掃描距離：較大的代碼從較遠的距離掃描效果較佳

What is QR Error Correction Level and Why Does It Matter?

QRErrorCorrectionLevel 決定容錯，共有四個等級：最高、高、中和低。 較高的修正等級可建立更複雜的 QR 代碼，即使在損壞或部分模糊的情況下，也能防止讀取錯誤。

QR錯誤校正等級.最高

可產生最複雜的 QR 碼，錯誤修正率為 30%。 支援標誌戳記或影像圖形。 適用於 客製化 QR 碼與標誌。

以最高錯誤修正等級產生的 QR code，顯示密集的黑白圖案與定位方塊

QR錯誤校正等級.高

應用 25% 的錯誤修正。 複雜度低於最高等級。 平衡耐用性與資料容量。

二維碼範例，以密集的資料樣式和標準定位元素顯示高錯誤修正等級

QR錯誤校正等級.中等

應用 15% 的錯誤修正。 製作 QR 碼的速度較快，但容易出錯。 適用於大多數商業應用，印刷清晰。

產生的 QR 代碼範例，顯示黑白資料矩陣與角落位置標記

QR錯誤校正等級.低

應用 7% 的錯誤修正，建立最不複雜的 QR 代碼。 在最佳掃描條件下需要最大資料容量時使用。

以低錯誤修正等級產生的 QR 碼範例，顯示標準的黑白模組圖案

何時應該使用不同的 QR 版本？

QR 版本 (1-40) 決定符號複雜度和資料容量。 較高版本會產生更複雜的程式碼，儲存更多資料。 將版本設定得太低會造成較大量資料的編碼問題。 版本 0 會根據編碼值自動指定適當的版本。 See QR Version for more information.

如何使用特定設定建立 QR 碼圖像？

使用 QRCodeWriter.CreateQrCode() 寫入 QR 代碼並將其儲存為影像：

using IronBarCode;

// Basic QR code creation
QRCodeWriter.CreateQrCode("IronBarcode1234", 250, QRCodeWriter.QrErrorCorrectionLevel.Medium, qrVersion: 0).SaveAsJpeg("QRMedium.jpeg");

// Advanced QR code with custom styling
var qrCode = QRCodeWriter.CreateQrCode("https://ironsoftware.com", 500, QRCodeWriter.QrErrorCorrectionLevel.High);

// Add logo and styling
qrCode.AddLogo("logo.png");
qrCode.ChangeBarCodeColor(System.Drawing.Color.DarkBlue);

// Save in multiple formats
qrCode.SaveAsPng("styled-qr.png");
qrCode.SaveAsPdf("styled-qr.pdf");
using IronBarCode;

// Basic QR code creation
QRCodeWriter.CreateQrCode("IronBarcode1234", 250, QRCodeWriter.QrErrorCorrectionLevel.Medium, qrVersion: 0).SaveAsJpeg("QRMedium.jpeg");

// Advanced QR code with custom styling
var qrCode = QRCodeWriter.CreateQrCode("https://ironsoftware.com", 500, QRCodeWriter.QrErrorCorrectionLevel.High);

// Add logo and styling
qrCode.AddLogo("logo.png");
qrCode.ChangeBarCodeColor(System.Drawing.Color.DarkBlue);

// Save in multiple formats
qrCode.SaveAsPng("styled-qr.png");
qrCode.SaveAsPdf("styled-qr.pdf");
Imports IronBarCode

' Basic QR code creation
QRCodeWriter.CreateQrCode("IronBarcode1234", 250, QRCodeWriter.QrErrorCorrectionLevel.Medium, qrVersion:=0).SaveAsJpeg("QRMedium.jpeg")

' Advanced QR code with custom styling
Dim qrCode = QRCodeWriter.CreateQrCode("https://ironsoftware.com", 500, QRCodeWriter.QrErrorCorrectionLevel.High)

' Add logo and styling
qrCode.AddLogo("logo.png")
qrCode.ChangeBarCodeColor(System.Drawing.Color.DarkBlue)

' Save in multiple formats
qrCode.SaveAsPng("styled-qr.png")
qrCode.SaveAsPdf("styled-qr.pdf")
$vbLabelText   $csharpLabel
二維碼範例，以標準尋找模式和資料編碼結構顯示中等錯誤修正等級

該代碼以 250 像素對字母數字值進行編碼，並進行中等程度的錯誤修正。 版本 0 可讓程式選擇適當的 QR 代碼版本。 SaveAsJpeg() 接受 JPEG 副檔名。

條碼影像產生的最佳實務

適用於生產應用程式：

1.選擇正確的格式：適用於網頁的 PNG、適用於存檔的 TIFF、適用於一般用途的 JPEG 2.測試掃描：使用多種掃描設備驗證 BarCode 3.應用適當的頁邊空白：使用條碼邊距設定進行可靠的掃描 4.考慮效能：探索 async 和多執行緒選項，以利於大量產出

如需其他範例和技術，請造訪我們的 C# BarCode 圖片產生器教學。

常見問題解答

如何在 C# 中使用一行代碼創建一個 BarCode 圖像？

使用 IronBarcode，您可以使用 BarcodeWriter.CreateBarcode() 方法在一行中创建一个条形码图像。只需傳入您的數據、編碼類型、寬度和高度，然後將其保存為一個圖像文件。例如IronBarCode.BarcodeWriter.CreateBarcode("Sample123", BarcodeEncoding.Code128, 250, 100).SaveAsPng("Barcode.png")；

BarCode 可以編碼哪些類型的資料？

IronBarcode 的 BarcodeWriter.CreateBarcode() 方法接受多種資料類型，包括位元組陣列、MemoryStreams 和字串。字符串的長度和接受的字符因條碼類型而異 - Code128支持完整的ASCII字符集，而UPC-A要求正好12位數字。對於二進位資料，您可以使用位元組來編碼複雜的資料結構。

影像產生支援哪些 BarCode 格式？

IronBarcode 支援多種條碼格式，包括線性/一維條碼（Code128、Code39、UPC-A、UPC-E、EAN-8、EAN-13）、二維條碼（QR Code、Data Matrix、PDF417、Aztec），以及特殊格式，如用於運輸的 MaxiCode 和用於零售的 Databar。每種格式都有其特定用途，Code128 可處理一般的字母數字資料，而 QR Code 則可為行動掃描提供優異的錯誤修正功能。

如何設定 BarCode 影像的尺寸？

您可以直接在 CreateBarcode() 方法参数中以像素为单位设置条码图像尺寸。IronBarcode 使用預設的寬度和高度都是 250px。某些條碼類型如QR和PDF417可能需要特定的尺寸以符合要求，當輸入尺寸與要求不符時，庫會自動調整。

我可以將產生的 BarCode 儲存為何種影像檔案格式？

IronBarcode 允許您使用 SaveAs() 方法將生成的條碼儲存為多種圖像格式。您可以使用 SaveAsPng() 保存為 PNG 格式，以及其他常見的格式，如 JPEG、BMP 和 TIFF。CreateBarcode() 所傳回的 GeneratedBarcode 物件提供了各種不同檔案類型的儲存方法。

我可以產生 QR 碼以及傳統的 BarCode 嗎？

是的，IronBarcode 完全支援 QR 代碼與傳統條碼的產生。您可以使用相同的 CreateBarcode() 方法，指定 BarcodeEncoding.QRCode 為編碼類型來建立 QR 代碼。QR 代碼具有優異的錯誤更正等優點，是移動掃描應用程式的理想選擇。

Hairil Hasyimi Bin Omar
Hairil Hasyimi Bin Omar
  立即與工程團隊聊天
軟體工程師
就像所有優秀的工程師一樣，Hairil 也是一位狂熱的學習者。他不斷精進 C#、Python 和 Java 的知識，利用這些知識為整個 Iron Software 的團隊成員增加價值。Hairil 從馬來西亞的 Universiti Teknologi MARA 大學加入 Iron Software 團隊，畢業於該校的化學與流程工程學系，並取得學士學位。
準備好開始了嗎？
Nuget 下載 2,070,733 | 版本： 2026.2 剛剛發布