How to Create Barcode Images

條碼值

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")

class="content-img-align-center">

class="center-image-wrapper">

QR碼值

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

QR碼大小

用戶還可以將QR碼的大小直接指定為Int32類型。 此方法中使用的QR碼大小的計量單位為像素(px)。 默認的QR碼大小為500 px。

QR錯誤校正級別

QRErrorCorrectionLevel是QRCodeWriter類的一個成員屬性，其中有4個字段：最高、高、中等和低。 基本上，這個屬性是QR碼的容錯級別，較高的校正級別會創建更複雜的QR碼，即使損壞或部分遮擋，仍然更不易讀取錯誤。 現在，讓我們詳細討論此屬性中的每個字段，並查看生成的QR碼在外觀上的差異。

QRErrorCorrectionLevel.Highest

以最高校正級別生成的QR碼將擁有最複雜的QR碼圖像，其中30%是錯誤校正。 生成的QR碼還可以在QR碼上加蓋徽標或圖像圖形。

class="content-img-align-center">

class="center-image-wrapper">

QRErrorCorrectionLevel.High

將屬性字段設置為高結果會在QR碼圖像中應用25%的錯誤校正。 這將比從QRErrorCorrectionLevel.Highest生成的QR碼圖像更少複雜。

class="content-img-align-center">

class="center-image-wrapper">

QRErrorCorrectionLevel.Medium

此字段僅在QR碼圖像中應用15%的錯誤校正。 通過使用此設置，用戶將能更快地生成QR碼； 但是，這們生成的QR碼更容易出錯。

class="content-img-align-center">

class="center-image-wrapper">

QRErrorCorrectionLevel.Low

這是錯誤校正級別的最低設置，僅在QR碼圖像中應用7%的錯誤校正，結果是最不複雜的QR碼。

class="content-img-align-center">

class="center-image-wrapper">

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

創建QR碼圖像

以下代碼片段演示了如何使用IronBarcode中的QRCodeWriter.CreateQrCode()方法來編寫QR碼並使用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")

class="content-img-align-center">

class="center-image-wrapper">

從上述代碼片段中，使用一個字母數字值作為要在QR碼中編碼的值，並使用250像素作為生成的QR碼的大小。 我們還指定了生成的QR碼的錯誤校正為中等，讓程序決定哪個QR版本適合我們的QR碼值。 除此之外，我們還使用了SaveAsJpeg()該命令將QR碼圖像文件名與圖像格式擴展名（在此例中為JPEG）一起作為參數進行保存。