国产化Excel处理组件Spire.XLS教程:使用 C# 将 DataTable 导出为 Excel 文件

在 C# 中将 DataTable 导出为 Excel 文件,是 .NET 开发中常见的任务,广泛应用于报表生成、日志导出、系统间数据共享等场景。通过使用独立的组件库,开发者可以轻松将 DataTable 数据写入 Excel 文件,并应用格式设置,生成专业、可直接使用的文档,无需复杂配置或依赖第三方办公软件。

本文将介绍如何使用 ++Spire.XLS for .NET++ 将 DataTable 导出为 Excel(.xlsx/.xls)文件,包含数据创建、导出保存、格式设置等实用步骤。

Spire.XLS for .NET试用下载

安装和配置 Spire.XLS

开始之前,请确保你的项目中已添加 ++Spire.XLS for .NET++

通过 NuGet 安装 Spire.XLS:

复制代码
CopyInstall-Package Spire.XLS 

++Spire.XLS++ 支持 .NET Framework、.NET Core、.NET 6/7+ 以及 ASP.NET 项目,且无需安装 Microsoft Office

分步操作:C# 将 DataTable 导出为 Excel 文件

下面的步骤将演示如何使用**++Spire.XLS++**将 DataTable 导出为 Excel 文件,包含数据准备、文件保存、网页流导出以及格式设置等内容。

第一步:创建示例 DataTable

先创建一个包含多列的 DataTable

复制代码
// 创建数据表
DataTable dt = new DataTable("员工信息");

// 添加列
dt.Columns.Add("员工编号", typeof(int));
dt.Columns.Add("姓名", typeof(string));
dt.Columns.Add("部门", typeof(string));
dt.Columns.Add("入职日期", typeof(DateTime));
dt.Columns.Add("工资", typeof(double));
dt.Columns.Add("是否全职", typeof(bool));
dt.Columns.Add("奖金系数", typeof(decimal));

// 添加数据行
dt.Rows.Add(1001, "张伟", "人事部", new DateTime(2021, 5, 10), 55000.5, true, 0.05m);
dt.Rows.Add(1002, "李娜", "技术部", new DateTime(2020, 11, 23), 72000.0, false, 0.03m);
dt.Rows.Add(1003, "王强", "财务部", new DateTime(2019, 8, 15), 63000.75, true, 0.07m);
dt.Rows.Add(1004, "赵敏", "市场部", new DateTime(2022, 3, 8), 48800.0, true, 0.06m);

此处为演示用示例数据,实际使用中可绑定任意业务生成的 DataTable。

第二步:导入 DataTable 并保存为 Excel 文件

将 DataTable 导入到工作表中,并保存为 Excel 文件:

复制代码
Workbook workbook = new Workbook();
workbook.Worksheets.Clear();
Worksheet sheet = workbook.Worksheets.Add(dt.TableName);

// 从 A1 单元格开始插入数据表
sheet.InsertDataTable(dt, true, 1, 1);

// 保存为 .xlsx 文件(推荐)
workbook.SaveToFile("员工信息.xlsx", FileFormat.Version2016);

// 保存为 .xls 文件(旧格式)
workbook.SaveToFile("员工信息.xls", FileFormat.Version97to2003);

说明:

  • Workbook 表示整个 Excel 文件。
  • InsertDataTable 方法将 DataTable 内容映射到 Excel 表格中。
  • SaveToFile 方法用于保存文件,支持多种 Excel 格式。

导出效果示意图:

第三步:在 ASP.NET 中以流形式导出

在 Web 项目中,通常需要将 Excel 文件直接以下载流的方式返回:

复制代码
MemoryStream stream = new MemoryStream();
workbook.SaveToStream(stream, FileFormat.Version2013);
stream.Position = 0;

将此 MemoryStream 返回到 ASP.NET 控制器中,即可触发浏览器下载。

设置导出文件的格式与样式

若希望导出的 Excel 文件更具可读性和专业感,可以对内容进行格式化:

复制代码
// 设置表头样式
CellRange header = sheet.Rows[0];
header.Style.Font.IsBold = true;
header.Style.Font.FontName = "微软雅黑";
header.Style.Font.Size = 13;
header.Style.Color = Color.LightGray;
header.Style.Borders[BordersLineType.EdgeBottom].LineStyle = LineStyleType.Thick;

// 设置数据行样式
for (int i =  1; i < sheet.Rows.Length; i++)
{
    CellRange dataRow = sheet.Rows[i];
    dataRow.Style.Font.FontName = "黑体";
    dataRow.Style.Font.Size = 11;
    dataRow.BorderInside();
}

// 设置日期列的显示格式
CellRange dateColumn = sheet.Range[2, 4, sheet.Rows.Length + 1, 4];
dateColumn.Style.NumberFormat = "yyyy-mm-dd";

// 自动调整列宽
sheet.AllocatedRange.AutoFitColumns();

关键方法说明:

  • Style: 控制字体、颜色、边框、数字格式等;
  • AutoFitColumns(): 自动调整列宽以适应内容;
  • NumberFormat: 格式化日期、货币等数据类型;
  • BorderInside(): 添加内边框,增强表格可读性。

格式化效果示意图:

常见问题及解决方案

问题描述 解决方法
文件无法打开或提示损坏 检查是否正确关闭流,且文件后缀与格式匹配
特殊字符或中文乱码 确保字符串为 UTF-8 编码,字体设置支持目标语言
列宽过窄导致显示不全 使用 AutoFitColumns() 自动调整,或手动设置 ColumnWidth

总结

借助 ++Spire.XLS++,开发者可轻松地将 C# 中的 DataTable 导出为 Excel 文件,支持 .xls 和 .xlsx 两种格式,且无需依赖 Office 环境。无论是桌面应用还是 Web 系统,该方法都能快速生成格式良好的 Excel 报表。

常见问答(FAQ)

Q1:如何将 DataTable 转换为 Excel 文件?

使用 sheet.InsertDataTable() 将 DataTable 写入工作表,然后调用 workbook.SaveToFile() 保存文件。

Q2:能否在 ASP.NET 中导出 DataTable 为 Excel?

可以,在 ASP.NET 控制器中生成工作簿,并以流的方式返回,实现下载功能。

Q3:.xlsx 与 .xls 有何区别?

.xlsx 是较新的格式,兼容 Excel 2007 及更高版本;.xls 为旧版格式(Excel 97-2003),行数限制为 65536 行。