用C#和NPOI 2.5.3实现Excel商品报表图片批量插入与智能排版
电商后台系统经常需要导出包含商品图片的报表,传统手工操作不仅效率低下,还容易出错。最近在重构一个跨境电商平台的订单导出模块时,我遇到了需要批量插入商品图并自动调整列宽的需求。经过多次实践,总结出一套基于NPOI 2.5.3的高效解决方案,现在分享给各位.NET开发者。
1. 环境准备与基础配置
在开始之前,我们需要确保开发环境正确配置。使用Visual Studio 2019或更高版本创建一个新的.NET Core 3.1或.NET 5/6项目。NPOI 2.5.3已经支持.NET Standard 2.0,这意味着它可以在各种.NET平台上运行。
通过NuGet安装NPOI最新稳定版:
bash复制Install-Package NPOI -Version 2.5.3
NPOI针对不同Excel格式有两个主要实现类:
| 格式类型 | 实现类 | 命名空间 | 文件扩展名 |
|---|---|---|---|
| XLS | HSSFWorkbook | NPOI.HSSF.UserModel | .xls |
| XLSX | XSSFWorkbook | NPOI.XSSF.UserModel | .xlsx |
提示:虽然XLS格式兼容性更好,但在处理大量图片时建议使用XLSX格式,它能更好地管理内存和文件大小。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 图片插入的核心实现
商品图片可能存储在本地文件系统或网络URL上,我们需要分别处理这两种情况。下面是一个完整的图片插入方法:
csharp复制public static void AddProductImageToCell(ISheet sheet, int rowIndex, int colIndex, string imagePath, IWorkbook workbook)
{
byte[] imageBytes;
// 从本地文件或网络URL加载图片
if (Uri.IsWellFormedUriString(imagePath, UriKind.Absolute))
{
using (var webClient = new WebClient())
{
imageBytes = webClient.DownloadData(imagePath);
}
}
else
{
imageBytes = File.ReadAllBytes(imagePath);
}
// 添加图片到工作簿
int pictureIndex = workbook.AddPicture(imageBytes, PictureType.JPEG);
// 创建绘图容器
IDrawing drawing = sheet.CreateDrawingPatriarch();
// 创建锚点定位图片位置
IClientAnchor anchor = workbook.GetCreationHelper().CreateClientAnchor();
anchor.Col1 = colIndex;
anchor.Row1 = rowIndex;
anchor.Col2 = colIndex + 1; // 跨一列
anchor.Row2 = rowIndex + 1; // 跨一行
// 插入图片
drawing.CreatePictur
