如何使用 IronBarcode 在 C# 中创建条码图像

哪些数据类型可用于 BarCode 值？

BarcodeWriter.CreateBarcode() 方法接受条形码值的多种数据类型：MemoryStream 和 string。 字符串长度和可接受的字符因 BarCode 类型而异，详情请参见我们的 API 文档。 Code128 支持完整的 ASCII 字符集，而 UPC-A 需要 12 位数字。 对于二进制数据，请使用 byte[] array 对复杂数据结构进行编码。

支持哪些 BarCode 编码类型？

IronBarcode 支持多种条形码格式，请参阅我们的 Supported Barcode Formats 一文了解完整列表。常用格式包括

• 线性/一维条形码：Code128、Code39、UPC-A、UPC-E、EAN-8、EAN-13
• 二维条形码：QR 码、数据矩阵、PDF417、阿兹特克码
• 专业格式：用于运输的 MaxiCode、用于零售的 Databar

每种格式都有特定的用途。 Code128 可以很好地处理一般的字母数字数据，而QR 代码则为移动扫描提供了卓越的纠错功能。

宽度和高度设置如何影响我的 BarCode？

以像素为单位设置输出 BarCode 图像的尺寸。 两者的默认测量值均为 250 px。 某些条形码类型(QR、PDF417)需要特定的尺寸才能符合要求。 当输入尺寸不符合要求时，条形码会以符合要求的尺寸生成，并以空白填充剩余空间。 尺寸太小会出现异常。

优化扫描：

• 线性条形码：保持宽度明显大于高度
• 二维条形码：二维码使用正方形尺寸(例如 250x250)
• 打印质量：更高的像素尺寸可提高更大物理尺寸的打印质量

我可以将 BarCode 导出到哪些图像格式？

来自 BarcodeWriter.CreateBarcode() 的 GeneratedBarcode 对象使用特定的 SaveAs() 方法保存为各种图像格式：

• SaveAsGif(): 保存为GIF 图像文件
• SaveAsJpeg(): 保存为JPEG 图像文件
• SaveAsPng(): 保存为PNG 图像文件(推荐用于网页)
• SaveAsTiff(): 保存为TIFF 图像文件(非常适合存档/打印)
• SaveAsWindowsBitmap(): 保存为BMP 图像文件
• SaveAsImage(): 通用方法——在文件路径中指定格式扩展名

此外，将条形码导出为流，用于内存处理或将条形码创建为 PDF 文档，用于文档集成。

QR 代码值可以使用哪些数据类型？

QRCodeWriter.CreateQrCode() 接受数字、字母或字母数字值，类型分别为 MemoryStream 或 System.String。二维码擅长存储：

• URL：引导用户访问网站或登陆页面
• 文本：最多可存储 4296 个字母数字字符
• 二进制数据：文件或复杂数据结构的编码
• 结构化数据：VCard、WiFi 证书或支付信息

有关 Unicode 支持和国际字符，请参阅我们的 编写 Unicode 条形码教程。

如何设置二维码大小？

直接以像素 (px)为单位指定二维码大小，格式为 Int32。 默认大小为 500 px。 考虑这些因素：

• 显示媒介：屏幕显示通常需要 200-400px
• 打印应用程序：使用 600px 或更高的分辨率以获得高质量的打印效果
• 扫描距离：代码越大，扫描距离越远

什么是 QR 纠错级别，为什么它很重要？

QRErrorCorrectionLevel 确定容错能力，分为四个级别：最高、高、中、低。 校正级别越高，生成的二维码越复杂，即使在损坏或部分模糊的情况下也不会出现读取错误。

QRErrorCorrectionLevel.Highest

生成最复杂的 QR 代码，纠错率达 30%。 支持徽标戳记或图像图形。 适用于定制带有徽标的二维码。

QRErrorCorrectionLevel.High

适用 25% 的纠错率。 复杂程度低于最高级别。 兼顾耐用性和数据容量。

QRErrorCorrectionLevel.Medium

适用 15% 的纠错率。 生成 QR 代码的速度更快，但容易出错。 适用于大多数商业应用，印刷清晰。

QRErrorCorrectionLevel.Low

应用 7% 的纠错功能，创建最不复杂的二维码。 在需要最大数据容量和最佳扫描条件时使用。

何时应使用不同的 QR 版本？

QR 版本(1-40)决定了符号的复杂程度和数据容量。 更高的版本会产生更复杂的代码，存储更多的数据。 将版本设置得过低会导致较大数据量的编码问题。 版本 0 会根据编码值自动分配相应的版本。 See QR Version for more information.

如何使用特定设置创建二维码图像？

使用 QRCodeWriter.CreateQrCode() 编写二维码并将其保存为图像：

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

代码以 250 像素对字母数字值进行编码，并进行中等程度的纠错。 版本 0 可让程序选择适当的二维码版本。 SaveAsJpeg() 接受带有 JPEG 扩展名的文件名。