Excel 作为最常用的数据管理与分析工具之一，被广泛应用于各类数据处理场景。在 C# 应用程序开发过程中，无论是生成业务报表、导出数据库查询结果，还是实现自动化办公流程，C# 写入 Excel 的功能都扮演着至关重要的角色。
借助 Spire.XLS for .NET这一强大的第三方库，开发者无需在运行环境中安装 Microsoft Excel，即可高效、灵活地实现 Excel 文件的创建、写入与导出操作。本文将系统讲解如何 使用 C# 写入 Excel 文件 ，包括不同数据类型的插入方法、批量数据写入技巧、文件保存与导出，助力开发者提升数据处理与自动化能力。
文章目录：
Spire.XLS for .NET 简介与安装
什么是 Spire.XLS for .NET
Spire.XLS for .NET 是由 E-iceblue 开发的一款专业 Excel 库。它允许开发人员在 C# 中写入 Excel 文件，并执行包括创建、编辑、读取和导出 Excel 文档在内的多种操作，而无需安装 Microsoft Excel。
主要功能包括：
- 通过编程写入和更新 Excel 文件
- 支持 Excel 格式（XLS、XLSX、CSV、ODS）
- 提供高级功能，如公式、图表、数据透视表和数据验证
- 将 Excel 导出为 PDF、HTML 和图片格式
- 在处理大型数据集时保持高性能，适用于桌面、服务器和 Web 应用程序
如何安装 Spire.XLS for .NET
方式一：通过 NuGet 安装（推荐）
- 打开 Visual Studio。
- 依次选择 工具 > NuGet 包管理器 > 管理解决方案的 NuGet 包...
- 搜索 Spire.XLS 并安装。
或直接使用包管理器控制台：
PM> Install-Package Spire.XLS
方式二：手动安装
- 从官网下载 Spire.XLS 安装包。
- 在项目中添加对 Spire.Xls.dll的引用。
安装完成后，你就可以在 C# 中开始写入 Excel 了。
如何在 C# 中创建 Excel 文件
第一步是创建一个新的工作簿并添加工作表，示例如下：
using Spire.Xls;
namespace CreateNewExcel
{
class Program
{
static void Main(string[] args)
{
// 创建一个新的工作簿
Workbook workbook = new Workbook();
// 移除默认工作表
workbook.Worksheets.Clear();
// 添加一个工作表
Worksheet sheet = workbook.Worksheets.Add("报告");
// 保存空的 Excel 文件
workbook.SaveToFile("新建文档.xlsx", ExcelVersion.Version2016);
workbook.Dispose();
}
}
}
此时，你已经成功创建了一个包含名为“报告”的工作表的空 Excel 文件。接下来我们将向其中写入数据。
C# 向 Excel 单元格写入不同数据类型
Spire.XLS 允许你直接将多种数据类型写入 Excel 单元格。常见示例如下：
写入文本
sheet.Range["A1"].Text = "你好 Excel!";
写入数字
sheet.Range["A2"].NumberValue = 123.45;
写入日期和时间
sheet.Range["A3"].DateTimeValue = DateTime.Now;
sheet.Range["A3"].NumberFormat = "yyyy-mm-dd hh:mm";
写入布尔值
sheet.Range["A4"].BooleanValue = true;
写入 TimeSpan
sheet.Range["A5"].TimeSpanValue = new TimeSpan(2, 30, 0);
sheet.Range["A5"].NumberFormat = "[h]:mm:ss";
插入公式
sheet.Range["A6"].Formula = "=SUM(A2,100)";
插入 HTML 格式字符串
string htmlText = "<span style=\"font-family: Times New Roman; color: blue; font-size: 15pt;\">HTML <strong>格式文本</strong></span>";
sheet.Range["A7"].HtmlString = htmlText;
写入通用值
sheet.Range["A8"].Value = "一般数据";
你可能会感兴趣：C# 读取 Excel 数据
C# 将批量数据写入 Excel 工作表
处理大型数据集时，逐个单元格写入效率很低。Spire.XLS 提供了直接插入数组和 DataTable 的方法，其他数据结构可以先转换为数组或 DataTable。
写入数组到 Excel
使用 Worksheet.InsertArray方法，可以将一维或二维数组写入指定区域：
string[,] data = {
{ "姓名", "年龄", "国家" },
{ "张三", "30", "中国" },
{ "李四", "28", "中国" },
{ "王五", "35", "加拿大" }
};
sheet.InsertArray(data, 1, 1);
效果图：
写入 DataTable 到 Excel
使用 InsertDataTable方法将 DataTable 数据导入到工作表：
DataTable dt = new DataTable();
dt.Columns.Add("ID", typeof(int));
dt.Columns.Add("产品", typeof(string));
dt.Columns.Add("价格", typeof(double));
dt.Rows.Add(1, "笔记本电脑", 8999);
dt.Rows.Add(2, "平板电脑", 5999);
dt.Rows.Add(3, "手机", 6999);
sheet.InsertDataTable(dt, true, 1, 1, true);
效果图：
此外，你还可以使用 Worksheet.ExportDataTable 方法将 Excel 数据导出为 DataTable。
写入 List 到 Excel
虽然 Spire.XLS 没有直接支持写入 List 的方法，但你可以先将 List 转换为 DataTable，再写入 Excel。
using Spire.Xls;
using System.Data;
namespace WriteListToExcel
{
class Program
{
static void Main(string[] args)
{
// 创建一个工作簿实例
Workbook workbook = new Workbook();
// 移除默认工作表
workbook.Worksheets.Clear();
// 添加一个工作表并命名
Worksheet worksheet = workbook.Worksheets.Add("成绩单");
// 创建一个学生数据列表
List<Student> students = new List<Student>
{
new Student("迈克尔", "约翰逊", 20, "计算机科学", 3.8),
new Student("莎拉", "威廉姆斯", 22, "数学", 3.6),
new Student("杰西卡", "布朗", 19, "物理", 3.9),
new Student("大卫", "史密斯", 21, "化学", 3.7),
new Student("艾米莉", "戴维斯", 23, "生物", 3.5)
};
// 将列表转换为数据表
DataTable dataTable = ConvertListToDataTable(students);
// 将数据表写入工作表
worksheet.InsertDataTable(dataTable, true, 1, 1, true);
// 设置列宽
worksheet.AllocatedRange.ColumnWidth = 12;
// 内容左对齐
worksheet.AllocatedRange.HorizontalAlignment = HorizontalAlignType.Left;
// 保存为Excel文件
workbook.SaveToFile("学生成绩单.xlsx", ExcelVersion.Version2016);
// 释放资源
workbook.Dispose();
}
static DataTable ConvertListToDataTable(List<Student> students)
{
DataTable dataTable = new DataTable();
// 添加列
dataTable.Columns.Add("名字", typeof(string));
dataTable.Columns.Add("姓氏", typeof(string));
dataTable.Columns.Add("年龄", typeof(int));
dataTable.Columns.Add("专业", typeof(string));
dataTable.Columns.Add("绩点", typeof(double));
// 添加行
foreach (var student in students)
{
DataRow row = dataTable.NewRow();
row["名字"] = student.FirstName;
row["姓氏"] = student.LastName;
row["年龄"] = student.Age;
row["专业"] = student.Major;
row["绩点"] = student.GPA;
dataTable.Rows.Add(row);
}
return dataTable;
}
}
class Student
{
public string FirstName { get; set; }
public string LastName { get; set; }
public int Age { get; set; }
public string Major { get; set; }
public double GPA { get; set; }
public Student(string firstName, string lastName, int age, string major, double gpa)
{
FirstName = firstName;
LastName = lastName;
Age = age;
Major = major;
GPA = gpa;
}
}
}
效果图：
保存和导出 Excel 文件
写入数据后，你需要保存或导出 Excel 文件。Spire.XLS 支持多种格式（XLSX、CSV、PDF 等）：
// 保存为 XLSX
workbook.SaveToFile("Output.xlsx", ExcelVersion.Version2016);
// 保存为 CSV
workbook.SaveToFile("Output.csv", ",", Encoding.UTF8);
// 导出为 PDF
workbook.SaveToFile("Output.pdf", FileFormat.PDF);
在 Web 应用中，还可以将文件保存到 MemoryStream：
using (MemoryStream ms = new MemoryStream())
{
workbook.SaveToStream(ms, FileFormat.Version2016);
// 可写入到 ASP.NET Response
}
常见问题与解决方案
日期/时间格式错误
- 问题：日期/时间显示为序列号。
- 解决办法：设置正确的单元格格式。
数据覆盖或错位
- 问题：数组或 DataTable 写入时覆盖现有数据。
- 解决办法：检查 InsertArray/InsertDataTable 的起始行列参数。
大数据集写入性能低
- 问题：数千行写入速度慢。
- 解决办法：使用批量写入方法，避免逐单元格写入。
公式未正确计算
- 问题：写入的公式未返回预期结果。
- 解决办法：检查公式语法，必要时调用 workbook.CalculateAllValue()。
总结
在 C# 中实现 Excel 写入功能既直观又高效。借助 Spire.XLS for .NET，无论是写入单个数值、文本、日期，还是处理大规模结构化数据集，都能轻松胜任。该库不仅支持单元格样式、公式计算、条件格式等高级功能，还能精准控制输出效果，确保最终生成的 Excel 文件数据准确、外观专业。
通过数组或 DataTable 进行批量数据写入，可大幅提升数据输出效率，灵活应对不同体量的数据导出需求。若你正在寻找一种稳定、高效且无需依赖 Microsoft Excel 环境的文件生成方案，Spire.XLS for .NET 无疑是一个理想的技术选择。
常见问答（FAQs）
Q1. 我能用 Spire.XLS 写入已有的 Excel 文件吗？
可以。使用 workbook.LoadFromFile("file.xlsx") 打开文件，然后修改并保存。
Q2. Spire.XLS 是否需要安装 Microsoft Excel？
不需要，它是一个独立库。
Q3. Spire.XLS 能处理包含成千上万行的大文件吗？
可以，它针对大数据集做了性能优化。
Q4. 写入数据时如何设置单元格样式？
你可以通过以下方式设置字体、颜色、边框和对齐方式：
sheet.Range["A1"].Style.Font.IsBold = true;
sheet.Range["A1"].Style.Color = Color.Yellow;
sheet.Range["A1"].Style.HorizontalAlignment = HorizontalAlignType.Left;
申请临时License
如果您需要去除生成文档中的评估提示或解除功能限制，请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。
