告别手动操作：教你用C# + Bartender自动化生成产品标签并导出PDF报告

工业级标签自动化：C#与Bartender的高效整合方案

在快节奏的现代制造业和电商物流中，每天处理成千上万的订单标签打印任务早已成为常态。传统的手动操作不仅效率低下，还容易出错。想象一下，当凌晨三点的订单高峰来临时，系统能否自动完成所有标签生成和报告整理？这正是C#与Bartender自动化方案要解决的核心痛点。

1. 环境搭建与基础配置

1.1 Bartender模板设计要点

Bartender作为行业领先的标签设计软件，其模板设计直接影响最终输出效果。建议从这几个维度优化模板：

• 数据字段定义：采用命名子字符串而非硬编码值，例如：

  btFormat.SetNamedSubStringValue("ProductCode", "A10086");

• 动态元素处理：二维码、条形码等可变内容需设置为"数据库字段"类型
• 多语言支持：通过条件格式实现标签语言的自动切换

关键技巧：在模板属性中勾选"Prompt for missing data"选项，便于调试时快速发现数据绑定问题。

1.2 C#项目初始化

创建.NET Core控制台应用后，需通过COM互操作引入Bartender：

dotnet new console -n LabelAutomation cd LabelAutomation dotnet add package Dapper

引用Bartender COM组件的正确方式：

// 在项目文件中添加COM引用 <ItemGroup> <COMReference Include="BarTender"> <Guid>{D7DFAC81-0D5F-11D2-B033-006008340032}</Guid> <VersionMajor>10</VersionMajor> <VersionMinor>0</VersionMinor> <Lcid>0</Lcid> <WrapperTool>tlbimp</WrapperTool> <Isolated>false</Isolated> </COMReference> </ItemGroup>

注意：Bartender版本差异可能导致接口变化，建议在开发环境安装与生产环境完全相同的版本

2. 数据库集成与数据处理

2.1 订单数据获取方案

采用Dapper实现高效数据查询：

public class OrderItem { public string SKU { get; set; } public string BatchNumber { get; set; } public DateTime ExpiryDate { get; set; } } public IEnumerable<OrderItem> GetPendingOrders() { using var conn = new SqlConnection(Config.DbConnection); return conn.Query<OrderItem>(@" SELECT TOP 1000 SKU, BatchNumber, ExpiryDate FROM Orders WHERE LabelPrinted = 0 ORDER BY Priority DESC"); }

2.2 数据批量处理策略

面对海量订单时，建议采用分页处理模式：

实现分页处理的代码示例：

const int pageSize = 500; int processed = 0; while(true) { var batch = GetOrderBatch(pageSize, processed); if (!batch.Any()) break; ProcessBatch(batch); processed += batch.Count(); }

3. 标签生成核心技术实现

3.1 动态打印控制

Bartender的打印控制API非常灵活，以下代码展示了关键参数配置：

var btApp = new BarTender.Application(); var format = btApp.Formats.Open(templatePath); // 设置打印机和份数 format.PrintSetup.Printer = printerName; format.PrintSetup.IdenticalCopiesOfLabel = copies; // 动态数据绑定 format.SetNamedSubStringValue("DATE", DateTime.Now.ToString("yyyy-MM-dd")); format.SetNamedSubStringValue("PO_NUMBER", order.PONumber); // 执行打印（不显示打印对话框） format.PrintOut(false, true);

3.2 多格式导出方案

除了打印，系统常需要导出图片或PDF：

public void ExportLabel(BarTender.Format format, string outputPath) { string extension = Path.GetExtension(outputPath).ToLower(); switch(extension) { case ".jpg": format.ExportToFile(outputPath, "JPG", BarTender.BtColors.btColors24Bit, BarTender.BtResolution.btResolutionPrinter); break; case ".pdf": format.ExportToFile(outputPath, "PDF", BarTender.BtColors.btColors24Bit, BarTender.BtResolution.btResolution300dpi); break; default: throw new NotSupportedException($"不支持的格式: {extension}"); } }

提示：PDF导出时建议分辨率设为300dpi以上，确保条形码扫描识别率

4. 高级应用与系统集成

4.1 多页PDF报告生成

使用iTextSharp合并多个标签到单个PDF：

public void MergeImagesToPdf(IEnumerable<string> imagePaths, string pdfPath) { using var doc = new iTextSharp.text.Document(); using var writer = PdfWriter.GetInstance(doc, new FileStream(pdfPath, FileMode.Create)); doc.Open(); foreach (var imgPath in imagePaths) { var img = iTextSharp.text.Image.GetInstance(imgPath); img.ScaleToFit(doc.PageSize.Width - 40, doc.PageSize.Height - 40); img.Alignment = iTextSharp.text.Image.ALIGN_CENTER; doc.NewPage(); doc.Add(img); } doc.Close(); }

4.2 自动化服务部署

将应用部署为Windows服务的要点：

1. 使用Microsoft.Extensions.Hosting.WindowsServices包
2. 实现后台任务执行逻辑
3. 配置服务恢复策略（首次失败→重启，第二次失败→重启，后续失败→无操作）

服务安装命令：

sc create LabelService binPath="C:\path\to\LabelAutomation.exe" start=auto

5. 性能优化与异常处理

5.1 资源泄漏预防

Bartender实例必须正确释放，推荐使用try-finally模式：

BarTender.Application btApp = null; try { btApp = new BarTender.Application(); // 业务逻辑... } finally { if (btApp != null) { btApp.Quit(BarTender.BtSaveOptions.btDoNotSaveChanges); Marshal.ReleaseComObject(btApp); } }

5.2 批量处理超时控制

针对大批量任务，需要实现超时中断机制：

var cts = new CancellationTokenSource(TimeSpan.FromMinutes(30)); Parallel.ForEach(orders, new ParallelOptions { CancellationToken = cts.Token, MaxDegreeOfParallelism = 4 }, order => { ProcessSingleOrder(order); });

实际项目中，我们曾用这套方案将某电商仓库的标签处理时间从8小时压缩到23分钟。最关键的优化点是采用并行处理+内存缓存，将Bartender模板加载次数减少了90%。