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

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

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

支持哪些 BarCode 编码类型？

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

• 线性/1D BarCode：Code128, Code39, UPC-A, UPC-E, EAN-8, EAN-13
• 2D BarCode：Aztec
• 专用格式：MaxiCode 用于发货，Databar 用于零售

每种格式都有特定的用途。 Code128 能很好地处理一般的字母数字数据，而QR码则为移动端扫描提供了更出色的纠错能力。

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

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

优化扫描：

• 线性条码: 保持宽度明显大于高度
• 2D条码: 使用正方形尺寸生成QR码（例如250x250）
• 打印质量：更高的像素尺寸可提高更大物理尺寸的打印质量

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

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

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

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

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

QRCodeWriter.CreateQrCode() 支持将数字、字母或字母数字值作为 MemoryStream 或 System.String 类型进行存储。QR码在存储以下内容方面表现出色：

• URLs: 将用户直接引导至网站或目标页
• 文本: 存储多达4,296个字母数字字符
• 二进制数据: 编码文件或复杂的数据结构
• 结构化数据: vCards、WiFi凭证或支付信息

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

如何设置二维码大小？

请直接以 Int32 格式指定QR码尺寸（单位为像素 px）。 默认大小为 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() 生成QR码并将其保存为图片：

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 扩展名的文件名。