C#使用Office Interop导出数据到Excel的方法

环境准备与依赖引用

在使用 COM 自动化操作 Office 应用程序前，必须确保运行代码的客户端机器上已安装 Microsoft Excel。此外，项目需要添加对 Office 互操作程序集的引用。

1. 添加引用：在 Visual Studio 项目中右键“引用” → “添加引用” → “COM”。在列表中找到并勾选 Microsoft.Office.Interop.Excel（通常名为 Microsoft Excel XX.0 Object Library）。
2. 引入命名空间：在代码文件中加入必要的 using 指令：

   using System.Data;
   using System.Windows.Forms;
   using Microsoft.Office.Interop.Excel;

核心逻辑与通用方法设计

为了复用代码，我们可以构建一个 CToExcel 类。该类包含两个核心的公共方法 ExportExcel，分别针对 ListView 和 DataTable 两种常见数据源提供导出支持。这两个方法的底层逻辑一致，均通过以下步骤完成：

第1步：触发保存文件对话框

导出过程的第一步是让用户选择存储路径。通过实例化 SaveFileDialog 来拦截用户的取消操作：

• 设置默认扩展名为 .xls，筛选器限制为“Excel文件|*.xls”。
• 展示对话框后，检查返回文件名是否包含冒号 :。如果包含（例如 D:\test.xlsx），说明用户选择了文件；若不包含，通常意味着用户点击了“取消”，此时直接返回退出函数。

第2步：初始化 Excel 进程与工作簿

通过反射或 COM 接口创建 Excel 应用程序对象。在此阶段需要进行异常处理，以捕获因未安装 Office 导致的启动失败：

1. 启动 Excel 后台服务：
   

   xlApp = new Application();

   建议在 try-catch 块中进行，捕获异常时提示用户检查环境。
2. 创建工作簿：通过 workbooks.Add(XlWBATemplate.xlWBATWorksheet) 添加一个新的空白工作表，并获取第一个 Worksheet 对象的引用用于后续数据写入。

第3步：写入表头与标题行（可选）

根据传入的参数 titleRowCount 决定如何处理顶部信息：

• 若 titleRowCount > 0：调用内部辅助方法 MergeCells 在第一行合并多列单元格，填入总标题文本（来源于 listView.Tag 或 dataTable.TableName）。
• 若为 0：则直接跳至下一行作为列标题起始点。
• 写入列名：遍历数据源的列集合，将 ColumnName 或 Column Header 依次写入对应列的标题行中。

第4步：循环写入数值数据

这是性能敏感的部分。遍历 Rows/Items 并嵌套遍历 Columns，将每个单元格的文本值赋值给 Excel 对应的 Cells[r, c]：

// 示例：DataRow 写入方式
worksheet.Cells[r + titleRowCount + 2, i + 1] = dataTable.Rows[r][i].ToString();

关键细节：在长数据集循环中加入 Application.DoEvents()，这允许 Windows 消息队列处理系统事件，防止用户在写入过程中感觉界面卡死或无响应。

第5步：格式调整与文件保存

数据填充完毕后，执行以下收尾动作：

1. 列宽自适应：调用 worksheet.Columns.EntireColumn.AutoFit()，让所有列宽自动适应内容长度。
2. 保存文件：调用 workbook.SaveCopyAs(saveFileName)。注意不要使用 SaveAs 除非你需要覆盖原文件或更改格式参数，因为 SaveCopyAs 更安全地保持当前模板状态。
3. 清理资源：这是最容易导致内存泄漏的步骤。

   xlApp.Quit(); // 关闭Excel进程
   Marshal.ReleaseComObject(worksheet);
   // ... 释放其他 COM 对象 ...
   GC.Collect(); // 强制垃圾回收，销毁残留的对象引用

   务必正确按顺序释放 COM 对象，否则可能导致后台残留多个 Excel.EXE 进程占用内存。

第6步：辅助功能 - 合并单元格

在处理报表式导出时，通常需要生成居中的大标题。以下为合并指定区域 Range 的 C# 实现：

public void MergeCells(Worksheet ws, int beginRow, int beginCol, int endRow, int endCol, string text)
{
    Range range = ws.get_Range(ws.Cells[beginRow, beginCol], ws.Cells[endRow, endCol]);
    range.ClearContents();
    range.MergeCells = true;
    range.Value2 = text;
    // 对齐方式设置
    range.HorizontalAlignment = XlHAlign.xlHAlignCenter;
    range.VerticalAlignment = XlVAlign.xlVAlignCenter;
}

注意事项与排错建议

• 版本兼容性：本方案生成的默认为 .xls (97-2003) 格式。如果需要生成现代 .xlsx 格式，需修改 XlFileFormat 常量或在另存为时指定格式枚举。
• 服务器端运行风险：切勿将此代码用于 IIS / ASP.NET Web 部署环境。Microsoft 明确不推荐在服务器端使用 Office Interop，这会导致严重的并发锁死和权限崩溃问题。
• 超时控制：对于万级以上的超大容量数据导出，单纯逐 Cell 赋值效率极低。建议改用数组批量写入（如 range.Value = object[,] dataMatrix;），或者考虑使用第三方库（如 EPPlus）。
• 未安装 Office 时的回退：代码中包含了对 COM 对象实例化的 try-catch，应妥善引导用户使用 CSV 或其他轻量级导出生成方案。

以上就是使用 C# 结合 Office Interop 将数据高效导出至 Excel 文件的详细内容，更多关于 C# 数据处理、桌面开发及 WinForms 进阶优化的资料请关注本站其它相关文章！