如何在C#中使用IronBarcode生成條碼

如何使用NuGet軟體包管理器安裝條碼生成程式庫？

打開Visual Studio，並在軟體包管理器控制台中使用以下命令安裝NuGet軟體包：

Install-Package BarCode

NuGet軟體包支持.NET 10, .NET 8, .NET 6, .NET Core, .NET Standard和.NET Framework，使其與Windows應用程式和跨平台.NET應用程式兼容。 IronBarcode支持部署到Docker容器、Azure和Linux伺服器。 在IronBarcode文件頁面和Iron Software GitHub專案上查找更多詳細信息和參考文檔。

安裝後，您會看到專案中可用的IronBarCode命名空間。 該程式庫無需在Windows上運行時的額外依賴項——在Linux上，您可能需要安裝一些系統程式庫，詳情請參考IronBarcode Linux 部署指南。

如何在C#中生成簡單的條碼圖像文件？

只需幾行程式碼即可創建條碼圖像。 以下示例顯示如何生成條碼並保存為PNG圖像文件：

using IronBarCode;

// Generate a simple barcode and encode the string data
var barcode = BarcodeWriter.CreateBarcode("SKU-78432-X", BarcodeWriterEncoding.Code128);

// Save the barcode as a PNG image file
barcode.SaveAsPng("product-barcode.png");

using IronBarCode;

// Generate a simple barcode and encode the string data
var barcode = BarcodeWriter.CreateBarcode("SKU-78432-X", BarcodeWriterEncoding.Code128);

// Save the barcode as a PNG image file
barcode.SaveAsPng("product-barcode.png");

該BarcodeWriterEncoding的條碼格式。 返回的GeneratedBarcode引用提供樣式方法和導出選項，可以保存為PNG, JPEG, BMP, TIFF, PDF或HTML。

如何創建QR Code和其他2D條碼類型？

IronBarcode支持所有主要條碼格式，包括2D條碼類型如QR Code和Data Matrix。 用類似的語法生成QR碼：

using IronBarCode;

// Create a QR code and encode URL data
var qrCode = BarcodeWriter.CreateBarcode(
    "https://ironsoftware.com/csharp/barcode/",
    BarcodeWriterEncoding.QRCode
);
qrCode.SaveAsPng("website-qr.png");

using IronBarCode;

// Create a QR code and encode URL data
var qrCode = BarcodeWriter.CreateBarcode(
    "https://ironsoftware.com/csharp/barcode/",
    BarcodeWriterEncoding.QRCode
);
qrCode.SaveAsPng("website-qr.png");

QR碼條碼類型在儲存URL和較大資料負載時表現出色。 該程式庫會自動處理錯誤更正，確保條碼即使部分損壞也能掃描。 默認情況下，IronBarcode使用錯誤更正級別M(中等)，這可以從大約15%的數據丟失中恢復——對於可能被刮傷或部分被遮擋的印刷條碼，您可以將其提高到級別H。

using IronBarCode;

// Generate an EAN-13 barcode compatible with UPC for retail print applications
var eanBarcode = BarcodeWriter.CreateBarcode("5901234123457", BarcodeWriterEncoding.EAN13);
eanBarcode.SaveAsPng("retail-product.png");

using IronBarCode;

// Generate an EAN-13 barcode compatible with UPC for retail print applications
var eanBarcode = BarcodeWriter.CreateBarcode("5901234123457", BarcodeWriterEncoding.EAN13);
eanBarcode.SaveAsPng("retail-product.png");

如何使用進階樣式選項創建具有自定義樣式的QR碼？

專業條碼生成通常需要進階樣式選項來調整顏色和添加註解。 GeneratedBarcode類提供帶有樣式方法的流暢API：

using IronBarCode;
using IronSoftware.Drawing;

// Create a styled barcode with advanced styling options
var styledBarcode = BarcodeWriter
    .CreateBarcode("INV-2025-001847", BarcodeWriterEncoding.Code128)
    .ResizeTo(400, 120)
    .SetMargins(20)
    .ChangeBarCodeColor(Color.DarkBlue)
    .AddAnnotationTextAboveBarcode("Invoice Number:")
    .AddBarcodeValueTextBelowBarcode();

// Verify to ensure proper scanning after styling
bool isReadable = styledBarcode.Verify();
Console.WriteLine($"Barcode verification: {(isReadable ? "PASS" : "FAIL")}");
styledBarcode.SaveAsPng("styled-invoice-barcode.png");

using IronBarCode;
using IronSoftware.Drawing;

// Create a styled barcode with advanced styling options
var styledBarcode = BarcodeWriter
    .CreateBarcode("INV-2025-001847", BarcodeWriterEncoding.Code128)
    .ResizeTo(400, 120)
    .SetMargins(20)
    .ChangeBarCodeColor(Color.DarkBlue)
    .AddAnnotationTextAboveBarcode("Invoice Number:")
    .AddBarcodeValueTextBelowBarcode();

// Verify to ensure proper scanning after styling
bool isReadable = styledBarcode.Verify();
Console.WriteLine($"Barcode verification: {(isReadable ? "PASS" : "FAIL")}");
styledBarcode.SaveAsPng("styled-invoice-barcode.png");

流暢的API允許您將樣式方法鏈接到一起，以一次性調整顏色、設置邊距和添加文字。 Verify()方法用於指示您的條碼是否仍然可以被機器識別——確保在生產中應用非標準顏色或調整到小尺寸後仍能被正確掃描。

將條碼顏色改為非常淺的色調或低對比的藍色背景可能會導致條碼無法掃描。 在任何顏色變更後，請務必調用Verify()。 如果驗證失敗，則需增加對比或恢復到黑條。 條碼樣式和自定義指南詳細介紹了所有可用的樣式方法。

為整個目錄使用一致樣式生成多個條碼，建立一個輔助方法，將標準樣式鏈應用到每個GeneratedBarcode實例。 此方法確保數千個生成圖像中具有統一的邊距、字體大小和顏色。

如何將條碼導出到不同的圖像格式？

為不同用途生成多種格式的條碼圖像。 該程式庫可以保存為PNG, JPEG, BMP, TIFF, PDF和HTML：

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("EXPORT-TEST", BarcodeWriterEncoding.Code128);

// Export barcode images to various formats
barcode.SaveAsPng("barcode.png");           // Web-compatible raster image
barcode.SaveAsJpeg("barcode.jpg");          // Compressed format for email attachments
barcode.SaveAsTiff("barcode.tiff");         // High-quality format for print workflows
barcode.SaveAsPdf("barcode.pdf");           // PDF document output
barcode.SaveAsHtmlFile("barcode.html");     // HTML for inline web embedding

// Get as bitmap stream for web APIs or database storage
System.IO.Stream barcodeStream = barcode.ToStream();
System.Drawing.Bitmap bitmapImage = barcode.ToBitmap();

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("EXPORT-TEST", BarcodeWriterEncoding.Code128);

// Export barcode images to various formats
barcode.SaveAsPng("barcode.png");           // Web-compatible raster image
barcode.SaveAsJpeg("barcode.jpg");          // Compressed format for email attachments
barcode.SaveAsTiff("barcode.tiff");         // High-quality format for print workflows
barcode.SaveAsPdf("barcode.pdf");           // PDF document output
barcode.SaveAsHtmlFile("barcode.html");     // HTML for inline web embedding

// Get as bitmap stream for web APIs or database storage
System.IO.Stream barcodeStream = barcode.ToStream();
System.Drawing.Bitmap bitmapImage = barcode.ToBitmap();

ToStream()方法返回與ASP.NET Core Web API和Blazor應用程式兼容的條碼數據。 System.Drawing.Bitmap引用，用於進一步的圖像處理。 有關在現有PDF文件上加蓋條碼的詳細信息，請參見<IronBarcode PDF條碼教程。

IronBarcode支持哪些跨平台.NET環境？

IronBarcode支持在所有主要.NET平台上生成條碼。 部署至：

IronBarcode Docker設置指南提供了有關容器化部署所需系統程式庫的詳細信息。 在Linux上運行時，通常需要在Docker映像中安裝libc6-dev。 在Alpine Linux上，需要稍微不同的一組套件——指南涵蓋了Ubuntu/Debian和Alpine Dockerfiles。

對於AWS Lambda部署，AWS Lambda部署指南解釋了如何將本地依賴包捆綁在部署包中，以及配置記憶體限制以處理條碼渲染工作負載。

如何在.NET中遵循條碼生成的最佳實踐？

在C#應用程式中生成條碼圖像時，遵循一致的實踐差異是在現場能夠可靠掃描的條碼和在銷售點或倉庫地板上失敗的條碼之間的區別。 以下準則適用於您選擇的任何條碼格式。

為您的使用案例選擇合適的條碼格式。選擇一種與您的掃描環境和數據要求匹配的格式。 對於超過80個字符的URL和數據負載，請使用QR碼。 在必須將字母數字數據裝在緊湊線性符號中的庫存和物流中使用Code 128。 對於需要在GS1系統中註冊的零售產品，使用EAN-13或UPC-A。 IronBarcode的條碼格式比較頁面提供了所有支持類型的並排參考，其容量限制和推薦的用例。

始終包括足夠的安靜區域。條碼周圍的空白區域——被稱為安靜區域——和條形一樣重要。 掃描器使用它來檢測符號的開始和結束。 使用SetMargins()方法在每側增加至少10像素的邊距用於數位顯示，對於列印輸出，則至少增加2.5毫米。 削減安靜區域是生產中掃描失敗的最常見原因之一。

在任何樣式更改後進行驗證。在調整顏色、應用漸變或調整到非標準尺寸後，請在Verify()。 如果返回false，標準硬體將無法可靠掃描您的條碼。 要麼增加對比，要麼減少樣式更改的複雜性。

對於大批量輸出，使用批處理生成模式。如果您的應用程式生成數千個條碼——例如產品標籤或運送清單——請在循環中處理它們，並重用相同的樣式配置。 避免在循環內加載字體資產或配置物件，因為這會產生不必要的開銷。 IronBarcode批量條碼生成示例展示了一種有效的循環模式，具有一致的輸出。

在多種掃描器型號和照明條件下進行測試。條碼掃描器在對低對比色、小模組大小和印刷質量的容差上各不相同。 在部暑之前，至少使用兩種不同的掃描器類型測試已印條碼。 對於屏幕上顯示的QR碼，在明亮和昏暗的光線下使用手機相機進行測試。 GS1條碼驗證標準頁面提供了零售條碼符號質量分級的權威指導。

尊重數據容量限制。每種條碼格式都有最大數據容量。 Code 128可以在符號過寬以至於不能以標準標籤尺寸打印之前，舒適地編碼大約48個字符。 QR碼容量取決於錯誤更正級別——在H級時，最大容量約為1,273個字母數字字符。 超出容量會強迫程式庫要麼拋出異常，要麼默默地降低質量。 查看Wikipedia上的QR碼數據容量參考以獲取快速容量表。

遵循.NET釋放模式。IDisposable。 將它們包裝在using聲明中以及時釋放非托管資源，特別是在條碼生成每次請求發生於高吞吐量網頁應用程式中時。

了解常見故障模式也有助於您編寫更具彈性的生成代碼。 掃描失敗的三個最常見原因是：不夠的安靜區域，條形顏色太接近背景顏色，條碼縮小到選擇的格式的最小模組尺寸以下的情況。 IronBarcode的Verify()方法在運行時捕捉到所有三個問題。

對於從生成的圖像中讀取條碼——進行回測或掃描上傳的文件——請參見IronBarcode條碼讀取器指南。 讀取器API反映了寫入器API的簡單性，並支持相同廣泛的格式。

Code 128的ISO/IEC 15417標準和QR碼的ISO/IEC 18004標準定義了IronBarcode遵循的技術規格。 檢視您目標條碼類型的相關標準有助於您理解程式庫必須工作的約束條件。

你的下一步行動是什麼？

本指南涵蓋了使用IronBarcode在C#中生成條碼圖像——從NuGet安裝到生成Code 128, QR碼和EAN-13、高級樣式設計、跨平台部暑及生產最佳實踐。

想要進一步瞭解，請探索以下資源：

• IronBarcode完整API參考——BarcodeWriter, GeneratedBarcode和所有枚舉的完整方法文檔
• IronBarcode條碼讀取器教程——從圖像、PDF和流中讀取和解碼條碼
• 批量條碼生成示例——針對標籤打印和出貨工作流程的大批量生成模式
• IronBarcode授權和定價——$799起的選項

下載IronBarcode以向您的.NET應用程式添加條碼功能，或開始免費30天試用，以便在您的環境中生成條碼圖像而不需授權金鑰。