USING IRONBARCODE
C# USB 条码扫描器：IronBarcode 集成完整指南
USB条形码扫描器可作为键盘输入设备，自动将扫描数据发送到C#应用程序。 IronBarcode处理此输入以验证格式、提取结构化数据并生成新的条形码，从而为库存管理系统创建完整的扫描解决方案，且部署复杂性极低。
零售、仓储和库存管理操作都依赖于高效的条形码扫描。 借助IronBarcode及其有效的验证和生成功能，开发人员可以构建可靠的 USB 条形码扫描器应用程序，这些应用程序的功能不仅限于简单的数据采集。 该库可以验证条形码数据，提取结构化信息，并即时生成新的条形码。
本指南演示如何在 C# 中将 USB 条形码扫描器与IronBarcode集成。 最终成果是一个可与.NET Framework 和 .NET 应用程序配合使用的实时扫描解决方案，可帮助团队高效地管理库存和跟踪物品。 无论是构建销售点系统还是企业库存管理解决方案，IronBarcode 的跨平台兼容性都能确保应用程序在Windows 、 Linux或macOS上流畅运行。
USB条码扫描仪如何与IronBarcode一起工作？
为什么键盘楔形模式对集成很重要？
大多数 USB 条形码扫描器以 HID 键盘楔形模式运行，模拟键盘输入，从而轻松扫描条形码。 扫描条形码时，扫描器会"输入"数据，然后按 Enter 键。 IronBarcode 通过验证格式、提取结构化数据以及响应扫描立即生成条形码来改进这种原始输入。
了解不同的扫描仪通信模式有助于企业应用。 专业扫描仪除了键盘楔形模式外，还支持串行通信和直接 USB HID 模式：
// Example: Handling different scanner input modes
public interface IScannerInput
{
event EventHandler<string> BarcodeScanned;
void StartListening();
void StopListening();
}
// Keyboard wedge implementation
public class KeyboardWedgeScanner : IScannerInput
{
public event EventHandler<string> BarcodeScanned;
private readonly TextBox _inputBox;
public KeyboardWedgeScanner(TextBox inputBox)
{
_inputBox = inputBox;
_inputBox.KeyPress += OnKeyPress;
}
private void OnKeyPress(object sender, KeyPressEventArgs e)
{
if (e.KeyChar == (char)Keys.Enter)
{
BarcodeScanned?.Invoke(this, _inputBox.Text);
_inputBox.Clear();
}
}
public void StartListening() => _inputBox.Focus();
public void StopListening() => _inputBox.Enabled = false;
}
// Serial port implementation for professional scanners
public class SerialPortScanner : IScannerInput
{
public event EventHandler<string> BarcodeScanned;
private System.IO.Ports.SerialPort _port;
public SerialPortScanner(string portName, int baudRate = 9600)
{
_port = new System.IO.Ports.SerialPort(portName, baudRate);
_port.DataReceived += OnDataReceived;
}
private void OnDataReceived(object sender, System.IO.Ports.SerialDataReceivedEventArgs e)
{
string data = _port.ReadLine().Trim();
BarcodeScanned?.Invoke(this, data);
}
public void StartListening() => _port.Open();
public void StopListening() => _port.Close();
}// Example: Handling different scanner input modes
public interface IScannerInput
{
event EventHandler<string> BarcodeScanned;
void StartListening();
void StopListening();
}
// Keyboard wedge implementation
public class KeyboardWedgeScanner : IScannerInput
{
public event EventHandler<string> BarcodeScanned;
private readonly TextBox _inputBox;
public KeyboardWedgeScanner(TextBox inputBox)
{
_inputBox = inputBox;
_inputBox.KeyPress += OnKeyPress;
}
private void OnKeyPress(object sender, KeyPressEventArgs e)
{
if (e.KeyChar == (char)Keys.Enter)
{
BarcodeScanned?.Invoke(this, _inputBox.Text);
_inputBox.Clear();
}
}
public void StartListening() => _inputBox.Focus();
public void StopListening() => _inputBox.Enabled = false;
}
// Serial port implementation for professional scanners
public class SerialPortScanner : IScannerInput
{
public event EventHandler<string> BarcodeScanned;
private System.IO.Ports.SerialPort _port;
public SerialPortScanner(string portName, int baudRate = 9600)
{
_port = new System.IO.Ports.SerialPort(portName, baudRate);
_port.DataReceived += OnDataReceived;
}
private void OnDataReceived(object sender, System.IO.Ports.SerialDataReceivedEventArgs e)
{
string data = _port.ReadLine().Trim();
BarcodeScanned?.Invoke(this, data);
}
public void StartListening() => _port.Open();
public void StopListening() => _port.Close();
}$vbLabelText $csharpLabel
开发人员如何捕获和验证扫描仪输入？
// Capture scanner input and validate with IronBarcode
private async void ProcessScannerInput(string scannedData)
{
try
{
// Validate the scanned data format
var validationBarcode = BarcodeWriter.CreateBarcode(scannedData, BarcodeEncoding.Code128);
var results = await BarcodeReader.ReadAsync(validationBarcode.ToBitmap());
if (results.Any())
{
var result = results.First();
// Extract metadata for enterprise systems
var scanMetadata = new ScanMetadata
{
BarcodeType = result.BarcodeType,
Value = result.Value,
Confidence = result.Confidence,
ScanTimestamp = DateTime.UtcNow,
ScannerDevice = GetCurrentScannerInfo()
};
await ProcessValidBarcode(scanMetadata);
}
else
{
HandleInvalidScan(scannedData);
}
}
catch (Exception ex)
{
LogScanError(ex, scannedData);
}
}// Capture scanner input and validate with IronBarcode
private async void ProcessScannerInput(string scannedData)
{
try
{
// Validate the scanned data format
var validationBarcode = BarcodeWriter.CreateBarcode(scannedData, BarcodeEncoding.Code128);
var results = await BarcodeReader.ReadAsync(validationBarcode.ToBitmap());
if (results.Any())
{
var result = results.First();
// Extract metadata for enterprise systems
var scanMetadata = new ScanMetadata
{
BarcodeType = result.BarcodeType,
Value = result.Value,
Confidence = result.Confidence,
ScanTimestamp = DateTime.UtcNow,
ScannerDevice = GetCurrentScannerInfo()
};
await ProcessValidBarcode(scanMetadata);
}
else
{
HandleInvalidScan(scannedData);
}
}
catch (Exception ex)
{
LogScanError(ex, scannedData);
}
}$vbLabelText $csharpLabel
这段代码通过各种方法捕获扫描器输入，并利用IronBarcode 的异步读取功能来验证扫描的数据，而不会阻塞 UI 线程。 置信度阈值功能确保生产环境中只处理高质量的扫描结果。
如何设置您的条码扫描仪项目？
有哪些必要的依赖项和配置？
首先，对于桌面场景，可以在 Visual Studio 中创建一个 Windows Forms 应用程序；对于基于 Web 的扫描应用程序，可以考虑使用Blazor 。 对于移动库存解决方案， .NET MAUI提供出色的跨平台支持，具备Android和iOS 功能。 然后通过 NuGet 包管理器控制台安装 IronBarcode ：
Install-Package BarCode
对于容器化部署， IronBarcode 可与 Docker 无缝协作，为企业环境提供部署清单。
快速入门：在 C# 中创建二维码图像
创建二维码会生成一个可视化的图像，将数据编码成可扫描的方块：
立即开始使用 NuGet 创建 PDF 文件：
使用 NuGet 包管理器安装 IronBarcode
复制并运行这段代码。
using IronBarCode; // Generate QR code from scanned inventory data string inventoryCode = "INV-2025-001"; var qrCode = BarcodeWriter.CreateQrCode(inventoryCode); // Apply styling for professional labels qrCode.ResizeTo(300, 300); qrCode.SetMargins(10); qrCode.ChangeQrCodeColor(IronSoftware.Drawing.Color.DarkBlue); // Add logo for branding qrCode.AddLogoToQrCode("company_logo.png", 60, 60); // Save as high-quality image qrCode.SaveAsPng("inventory_qr.png"); // Alternative: Save as PDF for printing qrCode.SaveAsPdf("inventory_qr.pdf");部署到您的生产环境中进行测试
应用程序应该包含哪些命名空间？
请将以下必要的命名空间添加到表单中，并参考文档中的示例：
using IronBarCode;
using System.Drawing;
using System.Linq;
using System.Threading.Tasks;
using System.IO.Ports; // For serial scanners
using System.Diagnostics; // For performance monitoringusing IronBarCode;
using System.Drawing;
using System.Linq;
using System.Threading.Tasks;
using System.IO.Ports; // For serial scanners
using System.Diagnostics; // For performance monitoring$vbLabelText $csharpLabel
开发人员应该如何配置扫描器输入表单？
企业应用受益于支持多种扫描仪品牌的灵活扫描仪配置系统：
public class ScannerConfiguration
{
public string ScannerType { get; set; } // "KeyboardWedge", "Serial", "USB-HID"
public string PortName { get; set; } // For serial scanners
public int BaudRate { get; set; } = 9600;
public string Terminator { get; set; } = "\r\n";
public bool EnableBeep { get; set; } = true;
// Brand-specific settings
public Dictionary<string, string> BrandSettings { get; set; } = new();
// Common scanner brand configurations
public static ScannerConfiguration GetHoneywellConfig()
{
return new ScannerConfiguration
{
ScannerType = "Serial",
BaudRate = 115200,
BrandSettings = new Dictionary<string, string>
{
{"Prefix", "STX"},
{"Suffix", "ETX"},
{"TriggerMode", "Manual"}
}
};
}
public static ScannerConfiguration GetSymbolConfig()
{
return new ScannerConfiguration
{
ScannerType = "KeyboardWedge",
BrandSettings = new Dictionary<string, string>
{
{"ScanMode", "Continuous"},
{"BeepVolume", "High"}
}
};
}
}public class ScannerConfiguration
{
public string ScannerType { get; set; } // "KeyboardWedge", "Serial", "USB-HID"
public string PortName { get; set; } // For serial scanners
public int BaudRate { get; set; } = 9600;
public string Terminator { get; set; } = "\r\n";
public bool EnableBeep { get; set; } = true;
// Brand-specific settings
public Dictionary<string, string> BrandSettings { get; set; } = new();
// Common scanner brand configurations
public static ScannerConfiguration GetHoneywellConfig()
{
return new ScannerConfiguration
{
ScannerType = "Serial",
BaudRate = 115200,
BrandSettings = new Dictionary<string, string>
{
{"Prefix", "STX"},
{"Suffix", "ETX"},
{"TriggerMode", "Manual"}
}
};
}
public static ScannerConfiguration GetSymbolConfig()
{
return new ScannerConfiguration
{
ScannerType = "KeyboardWedge",
BrandSettings = new Dictionary<string, string>
{
{"ScanMode", "Continuous"},
{"BeepVolume", "High"}
}
};
}
}$vbLabelText $csharpLabel
如何使用IronBarcode验证扫描的条码？
条形码验证的最佳方法是什么？
IronBarcode 擅长验证和解析多种格式的条形码数据。 该库支持Code 128 、 EAN-13和Code 39等一维条形码，以及QR 码和Data Matrix等二维格式。 以下是一种改进的验证方法：
public class BarcodeValidator
{
private readonly Dictionary<BarcodeType, Func<string, bool>> _validators;
public BarcodeValidator()
{
_validators = new Dictionary<BarcodeType, Func<string, bool>>
{
{ BarcodeType.Code128, ValidateCode128 },
{ BarcodeType.EAN13, ValidateEAN13 },
{ BarcodeType.UPCA, ValidateUPCA },
{ BarcodeType.QRCode, ValidateQRCode }
};
}
public async Task<ValidationResult> ValidateScannedBarcodeAsync(string scannedText)
{
var result = new ValidationResult();
try
{
// Attempt multiple barcode formats for flexibility
var encodings = new[] {
BarcodeEncoding.Code128,
BarcodeEncoding.EAN13,
BarcodeEncoding.UPCA,
BarcodeEncoding.QRCode
};
foreach (var encoding in encodings)
{
try
{
var barcode = BarcodeWriter.CreateBarcode(scannedText, encoding);
var validationResults = await BarcodeReader.ReadAsync(barcode.ToBitmap());
if (validationResults.Any())
{
var validated = validationResults.First();
result.IsValid = true;
result.Format = validated.BarcodeType;
result.Value = validated.Value;
result.Confidence = validated.Confidence;
// Apply format-specific validation
if (_validators.ContainsKey(validated.BarcodeType))
{
result.PassesBusinessRules = _validators___PROTECTED_LINK_35___;
}
break;
}
}
catch { /* Try next format */ }
}
// Handle GS1-128 for supply chain applications
if (!result.IsValid && IsGS1Format(scannedText))
{
result = await ValidateGS1BarcodeAsync(scannedText);
}
}
catch (Exception ex)
{
result.Error = ex.Message;
}
return result;
}
private bool ValidateEAN13(string value)
{
// EAN-13 checksum validation
if (value.Length != 13) return false;
int sum = 0;
for (int i = 0; i < 12; i++)
{
int digit = int.Parse(value[i].ToString());
sum += (i % 2 == 0) ? digit : digit * 3;
}
int checkDigit = (10 - (sum % 10)) % 10;
return checkDigit == int.Parse(value[12].ToString());
}
}public class BarcodeValidator
{
private readonly Dictionary<BarcodeType, Func<string, bool>> _validators;
public BarcodeValidator()
{
_validators = new Dictionary<BarcodeType, Func<string, bool>>
{
{ BarcodeType.Code128, ValidateCode128 },
{ BarcodeType.EAN13, ValidateEAN13 },
{ BarcodeType.UPCA, ValidateUPCA },
{ BarcodeType.QRCode, ValidateQRCode }
};
}
public async Task<ValidationResult> ValidateScannedBarcodeAsync(string scannedText)
{
var result = new ValidationResult();
try
{
// Attempt multiple barcode formats for flexibility
var encodings = new[] {
BarcodeEncoding.Code128,
BarcodeEncoding.EAN13,
BarcodeEncoding.UPCA,
BarcodeEncoding.QRCode
};
foreach (var encoding in encodings)
{
try
{
var barcode = BarcodeWriter.CreateBarcode(scannedText, encoding);
var validationResults = await BarcodeReader.ReadAsync(barcode.ToBitmap());
if (validationResults.Any())
{
var validated = validationResults.First();
result.IsValid = true;
result.Format = validated.BarcodeType;
result.Value = validated.Value;
result.Confidence = validated.Confidence;
// Apply format-specific validation
if (_validators.ContainsKey(validated.BarcodeType))
{
result.PassesBusinessRules = _validators___PROTECTED_LINK_35___;
}
break;
}
}
catch { /* Try next format */ }
}
// Handle GS1-128 for supply chain applications
if (!result.IsValid && IsGS1Format(scannedText))
{
result = await ValidateGS1BarcodeAsync(scannedText);
}
}
catch (Exception ex)
{
result.Error = ex.Message;
}
return result;
}
private bool ValidateEAN13(string value)
{
// EAN-13 checksum validation
if (value.Length != 13) return false;
int sum = 0;
for (int i = 0; i < 12; i++)
{
int digit = int.Parse(value[i].ToString());
sum += (i % 2 == 0) ? digit : digit * 3;
}
int checkDigit = (10 - (sum % 10)) % 10;
return checkDigit == int.Parse(value[12].ToString());
}
}$vbLabelText $csharpLabel
对于多页文档，IronBarcode 可以读取 PDF和多页 TIFF 文件中的条形码。
应用程序可以验证哪些条形码格式？
此验证方法支持所有主流的一维条形码格式和二维条形码格式。 对于特殊应用，IronBarcode 还支持供应链管理中常用的MSI 条码和GS1-128格式。
如何从扫描的输入生成响应条码？
应用程序何时应该根据扫描数据创建新的条形码？
将扫描数据转换为可用于标签、跟踪或库存管理的新条形码，并具备生产就绪功能。 IronBarcode 的生成功能支持从各种数据类型创建条形码。 将条形码导出为图像、 PDF 、 HTML或流：
public class InventoryBarcodeGenerator
{
private readonly string _labelPath = "labels";
public InventoryBarcodeGenerator()
{
// Ensure proper licensing for production use
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";
System.IO.Directory.CreateDirectory(_labelPath);
}
public async Task<GeneratedBarcode> GenerateInventoryLabelAsync(string productCode, InventoryAction action)
{
try
{
// Generate structured inventory code
var inventoryCode = GenerateStructuredCode(productCode, action);
// Create high-quality barcode with production settings
var barcode = BarcodeWriter.CreateBarcode(inventoryCode, BarcodeEncoding.Code128);
// Apply enterprise styling
barcode.ResizeTo(400, 120);
barcode.SetMargins(10);
barcode.AddAnnotationTextAboveBarcode(inventoryCode, IronSoftware.Drawing.Font.Arial, 12);
barcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.Black);
// Add data matrix for redundancy in warehouse environments
var dataMatrix = BarcodeWriter.CreateBarcode(inventoryCode, BarcodeEncoding.DataMatrix);
dataMatrix.ResizeTo(100, 100);
// Save with error handling
var timestamp = DateTime.Now.ToString("yyyyMMddHHmmss");
var fileName = $"{inventoryCode}_{timestamp}";
// Save as multiple formats for flexibility
await Task.Run(() =>
{
barcode.SaveAsPng($"{_labelPath}\\{fileName}.png");
barcode.SaveAsPdf($"{_labelPath}\\{fileName}.pdf");
barcode.SaveAsSvg($"{_labelPath}\\{fileName}.svg");
});
return new GeneratedBarcode
{
Code = inventoryCode,
LinearBarcodePath = $"{_labelPath}\\{fileName}.png",
DataMatrixPath = $"{_labelPath}\\{fileName}_dm.png",
Timestamp = DateTime.UtcNow
};
}
catch (Exception ex)
{
throw new BarcodeGenerationException($"Failed to generate barcode for {productCode}", ex);
}
}
private string GenerateStructuredCode(string productCode, InventoryAction action)
{
// Implement GS1 Application Identifiers for enterprise compatibility
var ai = action switch
{
InventoryAction.Receive => "10", // Batch/Lot number
InventoryAction.Ship => "400", // Customer purchase order
InventoryAction.Count => "37", // Quantity
_ => "91" // Internal use
};
return $"({ai}){DateTime.Now:yyMMdd}{productCode}";
}
}public class InventoryBarcodeGenerator
{
private readonly string _labelPath = "labels";
public InventoryBarcodeGenerator()
{
// Ensure proper licensing for production use
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";
System.IO.Directory.CreateDirectory(_labelPath);
}
public async Task<GeneratedBarcode> GenerateInventoryLabelAsync(string productCode, InventoryAction action)
{
try
{
// Generate structured inventory code
var inventoryCode = GenerateStructuredCode(productCode, action);
// Create high-quality barcode with production settings
var barcode = BarcodeWriter.CreateBarcode(inventoryCode, BarcodeEncoding.Code128);
// Apply enterprise styling
barcode.ResizeTo(400, 120);
barcode.SetMargins(10);
barcode.AddAnnotationTextAboveBarcode(inventoryCode, IronSoftware.Drawing.Font.Arial, 12);
barcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.Black);
// Add data matrix for redundancy in warehouse environments
var dataMatrix = BarcodeWriter.CreateBarcode(inventoryCode, BarcodeEncoding.DataMatrix);
dataMatrix.ResizeTo(100, 100);
// Save with error handling
var timestamp = DateTime.Now.ToString("yyyyMMddHHmmss");
var fileName = $"{inventoryCode}_{timestamp}";
// Save as multiple formats for flexibility
await Task.Run(() =>
{
barcode.SaveAsPng($"{_labelPath}\\{fileName}.png");
barcode.SaveAsPdf($"{_labelPath}\\{fileName}.pdf");
barcode.SaveAsSvg($"{_labelPath}\\{fileName}.svg");
});
return new GeneratedBarcode
{
Code = inventoryCode,
LinearBarcodePath = $"{_labelPath}\\{fileName}.png",
DataMatrixPath = $"{_labelPath}\\{fileName}_dm.png",
Timestamp = DateTime.UtcNow
};
}
catch (Exception ex)
{
throw new BarcodeGenerationException($"Failed to generate barcode for {productCode}", ex);
}
}
private string GenerateStructuredCode(string productCode, InventoryAction action)
{
// Implement GS1 Application Identifiers for enterprise compatibility
var ai = action switch
{
InventoryAction.Receive => "10", // Batch/Lot number
InventoryAction.Ship => "400", // Customer purchase order
InventoryAction.Count => "37", // Quantity
_ => "91" // Internal use
};
return $"({ai}){DateTime.Now:yyMMdd}{productCode}";
}
}$vbLabelText $csharpLabel
对于特殊需求，开发人员可以创建 1-BPP 条形码图像以进行高对比度打印，或在现有 PDF 上盖章条形码。
生成的条形码有哪些自定义选项？
IronBarcode 提供丰富的自定义选项，包括颜色更改、边距设置以及带有徽标嵌入的二维码样式。
免费开始
免费开始
预定免费现场演示
无需信用卡或创建账户
