在C#项目里，导出Excel是很多后台管理、报表系统的标配能力。如果每次都直接调用NPOI或者Microsoft Office Interop的底层接口，不仅代码重复，还容易因为样式、列宽、数据类型处理不一致而出错。把导出逻辑收拢到一个封装类里，可以让页面或业务层只关心数据和文件名，其余细节全部交给类内部处理。
一、为什么需要封装Excel导出类
直接在按钮事件里写Excel导出，看似省事，实则隐患不少。比如同一个系统里，订单页导出的表头颜色和库存页不一样，后期维护时要改好几处；又或者某天项目从Net Framework迁到Net Core，原本依赖的COM组件用不了，所有页面都要重写。封装类的价值就是把“怎么写Excel”和“写什么数据”拆开。
一个设计良好的封装类，通常只提供类似ExportToExcel(DataTable data, string fileName)这样的公开方法。内部自行决定用NPOI的XSSFWorkbook还是HSSFWorkbook，自行设置默认字体、边框和自动列宽。调用方不需要引用任何Office相关命名空间，也不需要处理流关闭，复杂度被压到最低。
二、封装类的基础结构设计
我们先定义一个名为ExcelExporter的类，它不依赖具体页面，放在独立类库或工具文件夹中即可。核心字段可以包括工作簿对象、当前sheet以及默认样式。为了让WinForm和Web都能用，方法最后返回byte数组或者提供保存文件路径的重载。
下面这段示例代码展示了类骨架与最简导出方法。注意代码里所有小于号都大于号都做了转义，避免被当成标签。
using System.Data;
using System.IO;
using NPOI.SS.UserModel;
using NPOI.XSSF.UserModel;
public class ExcelExporter
{
private IWorkbook _workbook;
private ISheet _sheet;
// 导出DataTable为xlsx格式的字节数组
public byte[] ExportToExcel(DataTable table, string sheetName = "Sheet1")
{
_workbook = new XSSFWorkbook();
_sheet = _workbook.CreateSheet(sheetName);
// 写表头
IRow headerRow = _sheet.CreateRow(0);
for (int i = 0; i < table.Columns.Count; i++)
{
headerRow.CreateCell(i).SetCellValue(table.Columns[i].ColumnName);
}
// 写数据行
for (int r = 0; r < table.Rows.Count; r++)
{
IRow row = _sheet.CreateRow(r + 1);
for (int c = 0; c < table.Columns.Count; c++)
{
row.CreateCell(c).SetCellValue(table.Rows[r][c].ToString());
}
}
using (MemoryStream ms = new MemoryStream())
{
_workbook.Write(ms);
return ms.ToArray();
}
}
}
上面的代码虽然简单，但已经把“建工作簿、建sheet、填表头、填数据、转流”这几步固化下来。如果以后要支持xls老格式，只需在方法里根据后缀创建HSSFWorkbook，对外方法签名完全不用变。
三、在WinForm中调用封装类
桌面程序导出Excel通常希望直接弹出保存框。我们可以给ExcelExporter加一个接收保存路径的重载，或者在窗体里拿到byte数组后自己写文件。下面演示按钮事件里的调用方式，业务代码非常干净。
这种写法把UI和导出逻辑解耦，测试时也能直接new一个Exporter传假数据，不依赖界面。同时异常建议统一在封装类里用try-catch包住，向外抛自定义异常，避免每个按钮都写一遍错误处理。
private void btnExport_Click(object sender, EventArgs e)
{
DataTable dt = GetOrderData(); // 业务方法，获取数据源
ExcelExporter exporter = new ExcelExporter();
byte[] fileBytes = exporter.ExportToExcel(dt, "订单表");
string path = Path.Combine(Application.StartupPath, "订单表.xlsx");
File.WriteAllBytes(path, fileBytes);
MessageBox.Show("导出成功：" + path);
}
四、在Web API中返回Excel文件
Web场景不能写本地路径，而是要把字节数组作为文件流返回给浏览器。封装类不用改，只需要在控制器里用FileResult包裹。下面以ASP.NET Core为例，展示如何复用同一个ExcelExporter。
这里的关键是设置正确的Content-Type和下载文件名。由于封装类返回的是byte数组，内存占用可控，配合using释放工作簿，能支撑日常几千行数据的导出。若数据量极大，可在封装类内部改为逐行写盘再返回FileStream，但对外接口仍可保持一致性。
[HttpGet("export")]
public IActionResult ExportOrders()
{
DataTable dt = _orderService.QueryAll();
ExcelExporter exporter = new ExcelExporter();
byte[] bytes = exporter.ExportToExcel(dt, "订单报表");
return File(bytes,
"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
"订单报表.xlsx");
}
五、增强封装：样式与泛型支持
基础版只写了文字，实际项目常要求表头加粗、内容居中、某列设为日期格式。我们可以把样式设置挪到封装类的私有方法里，并在写表头时统一应用。更进一步，可以提供一个接收List<T>的泛型方法，利用反射读属性名作为列，减少调用方转换DataTable的步骤。
泛型方法虽然方便，但要注意属性可能是复杂对象，需要决定是ToString还是忽略。封装类内部用Attribute标记列名和顺序是不错的实践，但这部分逻辑仍对调用方透明。最终效果就是：无论控制台、WinForm还是Web，一行调用就能拿到规范格式的Excel。
public byte[] ExportToExcel<T>(List<T> list, string sheetName = "Sheet1")
{
DataTable dt = new DataTable();
var props = typeof(T).GetProperties();
foreach (var p in props)
{
dt.Columns.Add(p.Name);
}
foreach (var item in list)
{
DataRow row = dt.NewRow();
for (int i = 0; i < props.Length; i++)
{
row[i] = props[i].GetValue(item)?.ToString() ?? "";
}
dt.Rows.Add(row);
}
return ExportToExcel(dt, sheetName);
}
六、常见误区与小结
有人喜欢在封装类里直接new Excel.Application做COM导出，这在服务器上会因为没有装Office而崩溃，而且权限配置麻烦。优先选NPOI或EPPlus这类纯托管库，部署简单。另一个误区是把封装类写成静态类还持有状态字段，多线程导出时会互相覆盖，应设计为实例类或无状态静态方法。
整体来看，用C#调用一个封装好的导出类，本质是把变化点收敛。业务侧只看到数据进、文件出，底层换库、改样式、适配新框架都不用动业务代码。新手从本文的示例改起，逐步补上样式和异常管理，就能搭出顺手的报表导出方案。