使用C#将DataTable导出为Excel文件的实现教程

 更新时间:2025年08月08日 09:49:00   作者:CodeCraft Studio  
在C#中将DataTable导出为Excel文件,是.NET开发中常见的任务,广泛应用于报表生成、日志导出、系统间数据共享等场景,本文将介绍如何使用 Spire.XLS for .NET 将 DataTable 导出为 Excel(.xlsx/.xls)文件,需要的朋友可以参考下

在 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 行。

以上就是使用C#将DataTable导出为Excel文件的实现教程的详细内容,更多关于C# DataTable导出为Excel的资料请关注脚本之家其它相关文章!

相关文章

  • C#绘制中国国旗的方法

    C#绘制中国国旗的方法

    这篇文章主要介绍了C#绘制中国国旗的方法,以实例形式较为详细的分析了C#图形绘制的相关技巧,具有一定参考借鉴价值,需要的朋友可以参考下
    2015-08-08
  • C#微信开发第一章

    C#微信开发第一章

    这篇文章主要为大家详细介绍了C#微信开发第一章,很有参考价值和实用性,感兴趣的小伙伴们可以参考一下
    2016-07-07
  • C# 中SharpMap的简单使用实例详解

    C# 中SharpMap的简单使用实例详解

    SharpMap是一个基于.net 2.0使用C#开发的Map渲染类库,可以渲染各类GIS数据(目前支持ESRI Shape和PostGIS格式),可应用于桌面和Web程序,具体内容详情大家参考下本文吧
    2017-08-08
  • 基于C#实现屏幕录制功能

    基于C#实现屏幕录制功能

    在许多应用场景中,屏幕录制是一项非常有用的功能,不管是用于教学、演示、故障排查还是游戏录制,本文将详细介绍如何使用 C# 实现屏幕录制功能,帮助大家快速掌握这一实用技能,需要的朋友可以参考下
    2025-03-03
  • 基于C#实现自定义计算的Excel数据透视表

    基于C#实现自定义计算的Excel数据透视表

    数据透视表(Pivot Table)是一种数据分析工具,通常用于对大量数据进行汇总、分析和展示,本文主要介绍了C#实现自定义计算的Excel数据透视表的相关知识,感兴趣的可以了解下
    2023-12-12
  • C# 三种方式实现Socket数据接收

    C# 三种方式实现Socket数据接收

    这篇文章主要给大家分享三种实现C# 实现Socket数据接收的方式,接下俩小编就来为大家详细介绍吧,需要的朋友可以参考一下
    2021-10-10
  • Unity Shader实现动态过场切换图片效果

    Unity Shader实现动态过场切换图片效果

    这篇文章主要为大家详细介绍了Unity Shader实现动态过场切换图片效果,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-07-07
  • AOP从静态代理到动态代理(Emit实现)详解

    AOP从静态代理到动态代理(Emit实现)详解

    AOP为Aspect Oriented Programming的缩写,意思是面向切面编程的技术。下面这篇文章主要给大家介绍了关于AOP从静态代理到动态代理(Emit实现)的相关资料,文中通过示例代码介绍的非常详细,需要的朋友可以参考下
    2018-09-09
  • C#中的图像Image类与打印Printing类用法

    C#中的图像Image类与打印Printing类用法

    这篇文章介绍了C#中图像Image类与打印Printing类的用法,文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-05-05
  • C#使用控制台列出当前所有可用的打印机列表

    C#使用控制台列出当前所有可用的打印机列表

    这篇文章主要介绍了C#使用控制台列出当前所有可用的打印机列表,涉及C#操作计算机硬件的相关使用技巧,非常具有实用价值,需要的朋友可以参考下
    2015-04-04

最新评论