如何使用 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")

二维码值

类似于BarcodeWriter.CreateBarcode()方法，QRCodeWriter.CreateQrCode()首先接受一个值，该值可以是数字、字母或字母数字。 这些值可以作为byte[] array、MemoryStream和System.String类型输入。

二维码大小

用户还可以直接在方法中指定二维码的大小，类型为Int32。 该方法使用的二维码大小的度量单位是像素（px）。 默认的二维码大小为500 px。

二维码错误纠正级别

QRErrorCorrectionLevel是QRCodeWriter类的一个成员属性，其中有4个字段：最高、高、中和低。 基本上，这个属性是二维码的容错能力水平，较高的纠正级别会产生更复杂的二维码，这样即使被损坏或部分遮挡，也不容易读错。 现在，让我们详细讨论这个属性中的每个字段，并看看产生的二维码在外观上的区别。

QRErrorCorrectionLevel.Highest

使用最高纠正级别生成的二维码将拥有最复杂的二维码图像，其中30%用于错误纠正。 产生的二维码还可以在二维码上加盖标志或图形。

QRErrorCorrectionLevel.High

将属性字段设置为高，将导致应用25%的错误纠正到二维码图像中。 它会比QRErrorCorrectionLevel.Highest产生的二维码图像更简单。

QRErrorCorrectionLevel.Medium

这个字段在二维码图像上只应用15%的错误纠正。 通过使用这个设置，用户将获得更快捷的二维码生成； 然而，它们更容易出错。

QRErrorCorrectionLevel.Low

这是最低的错误纠正级别设置，仅在二维码图像上应用7%的错误纠正，导致最简单的二维码。

二维码版本

二维码版本是二维码的符号版本，范围从1到40。较高的二维码版本将生成更复杂的二维码，使用户能够存储更多的数据，而较低版本则相反。 请注意，如果二维码版本设置得太低，当用户试图编码超过版本允许的数据时可能会发生问题。 将二维码版本设置为0将根据要编码的值自动分配适当的二维码版本。 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格式保存二维码图像文件名。