如何使用 IronBarcode 在 C# 中建立條碼影像

條碼值

BarcodeWriter.CreateBarcode()方法接受條碼值的多種資料型別。 其中包括byte[] array 、 MemoryStream和string 。 字串的長度以及可接受的字元因條碼類型而異，但所有這些都在我們的文件中有詳細說明。

條碼編碼類型

IronBarcode 支援多種條碼格式的寫入——完整的清單可以在我們的"支援的條碼格式"文章中找到。 這些條碼類型都有其獨特的屬性、特性和用途——您可以參考我們的文檔，研究哪一種最適合您的使用情境。

寬度和高度

以像素為單位設定輸出條碼影像的寬度和高度。 預設情況下，兩個測量值都設定為 250 px。 一些條碼類型，例如 QR 碼和 PDF417 碼，需要一定的尺寸才能符合要求，因此對於輸入的寬度和高度與條碼所需尺寸不符的情況，條碼將按照符合要求的尺寸生成，剩餘空間將用空白填充。 如果條碼尺寸太小，將會拋出例外。

將條碼導入為影像

使用BarcodeWriter.CreateBarcode()方法建立條碼時，將產生一個GeneratedBarcode物件。 有了這個對象，我們可以將條碼保存為各種圖像類型，每個圖像格式都有特定的SaveAs()方法。 這些方法包括：

• SaveAsGif() : 此方法將GeneratedBarcode儲存為GIF 影像文件，並接受影像檔案路徑作為字串參數。
• SaveAsJpeg() : 此方法將GeneratedBarcode儲存為JPEG 影像文件，並接受影像檔案路徑作為字串參數。
• SaveAsPng() : 此方法將GeneratedBarcode儲存為PNG 映像文件，並接受影像檔案路徑作為字串參數。
• SaveAsTiff() : 此方法將GeneratedBarcode儲存為TIFF 影像文件，並接受影像檔案路徑作為字串參數。
• SaveAsWindowsBitmap() : 此方法將GeneratedBarcode儲存為BMP 映像文件，並接受映像檔路徑作為字串參數。
• SaveAsImage() ：這是一個GeneratedBarcode儲存為影像檔案的通用方法－使用者在輸入檔案路徑時必須指定所需的檔案格式副檔名。

生成條碼並另存為圖像文件

現在我們將使用BarcodeWriter.CreateBarcode()來示範如何建立一個 Code128 條碼，並將其儲存為 JPEG 映像檔到磁碟。

:path=/static-assets/barcode/content-code-examples/how-to/create-barcode-images-one-dimensional.cs

using IronBarCode;

BarcodeWriter.CreateBarcode("IronBarcode123", BarcodeEncoding.Code128, 200, 100).SaveAsJpeg("OneDBarcode.jpeg");

Imports IronBarCode

BarcodeWriter.CreateBarcode("IronBarcode123", BarcodeEncoding.Code128, 200, 100).SaveAsJpeg("OneDBarcode.jpeg")

QR 圖碼值

與BarcodeWriter.CreateBarcode()方法類似， QRCodeWriter.CreateQrCode()首先接受一個 QR 碼的值，該值可以是數字、字母或字母數字。 這些值可以作為byte[] array 、 MemoryStream和System.String類型輸入到方法中。

QR 圖碼尺寸

使用者也可以直接在方法中以Int32類型指定二維碼的大小。 本方法中所使用的二維碼尺寸測量單位為像素（px） 。 預設二維碼尺寸為 500 像素。

二維碼糾錯級別

QRErrorCorrectionLevel是QRCodeWriter類別的一個成員屬性，它有 4 個欄位： Highest 、 High 、 Medium和Low 。 基本上，該屬性是二維碼的容錯級別，更高的糾錯級別會創建更複雜的二維碼，即使二維碼損壞或部分遮擋，也不容易出現讀取錯誤。 現在，讓我們詳細討論此屬性中的每個字段，並查看生成的二維碼外觀上的差異。

QR錯誤校正等級.最高

使用最高糾錯等級產生的二維碼將具有最複雜的二維碼影像，其中 30% 用於糾錯。 產生的二維碼還可以印上徽標或圖像。

QR錯誤校正等級.高

將該屬性欄位設為"高"將導致二維碼影像套用 25% 的誤差校正。 它將比由QRErrorCorrectionLevel.Highest產生的 QR 碼影像更簡單。

QR錯誤校正等級.中等

此欄位僅對二維碼影像套用 15% 的糾錯率。 使用此設置，使用者可以更快地產生二維碼； 但是，它們更容易出錯。

QR錯誤校正等級.低

這是糾錯等級的最低設置，僅對二維碼影像應用 7% 的糾錯，從而產生最不複雜的二維碼。

QR 圖碼版本

QR 版本是指 QR 碼的符號版本，範圍從 1 到 40。 QR 版本越高，產生的 QR 碼越複雜，使用者可以儲存更多資料；反之亦然，QR 版本越低，產生的 QR 碼越複雜。 但請注意，如果二維碼版本設定得太低，當使用者嘗試編碼的資料超過該版本允許的資料量時，可能會出現問題。 將 QR 版本設為 0 將根據要編碼的值自動分配相應的 QR 版本。 Please refer to this site for more information on QR version: QR Version

建立二維碼圖像

下面的程式碼片段示範如何在 IronBarcode 中使用QRCodeWriter.CreateQrCode()方法編寫二維碼，並使用SaveAsJpeg()方法將其儲存為映像檔到磁碟。

:path=/static-assets/barcode/content-code-examples/how-to/create-barcode-images-qr.cs

using IronBarCode;

QRCodeWriter.CreateQrCode("IronBarcode1234", 250, QRCodeWriter.QrErrorCorrectionLevel.Medium, qrVersion: 0).SaveAsJpeg("QRMedium.jpeg");

Imports IronBarCode

QRCodeWriter.CreateQrCode("IronBarcode1234", 250, QRCodeWriter.QrErrorCorrectionLevel.Medium, qrVersion:= 0).SaveAsJpeg("QRMedium.jpeg")

從上面的程式碼片段可以看出，我們使用字母數字值作為二維碼中要編碼的值，並使用 250 像素作為產生的二維碼的尺寸。 我們也指定產生的二維碼的糾錯等級為中等，並讓程式決定哪個二維碼版本適合我們的二維碼值。 除此之外，我們還使用了SaveAsJpeg() ，該函數接受二維碼影像檔案名稱以及影像格式副檔名（在本例中為 JPEG）作為參數進行儲存。