当前位置：首页 > news >正文

国产化Excel处理组件Spire.XLS教程：使用 C# 从数据库导出数据到 Excel（含 SQL 示例）

news 2025/8/20 8:21:55

在企业应用开发中，Excel 通常被用作在技术人员与业务人员之间传递结构化数据的桥梁，因其格式灵活、易于共享且用户普遍熟悉。而将数据库数据导出为 Excel 文件，也因此成为实现报表生成、审计追踪、数据迁移和临时分析等需求时的一种高频操作。

E-iceblue旗下Spire系列产品是文档开发领域的佼佼者，支持国产化信创。本文将介绍如何使用 Spire.XLS for .NET 通过 C# 将数据库记录高效导出到 Excel 文件。示例以 SQL Server 数据库为基础，但相同方法也适用于 SQLite、MySQL、Oracle 等其他关系型数据库，只需调整连接方式即可。

Spire.XLS for .NET试用下载

准备工作

在开始编码之前，请先确认开发环境已就绪：

.NET 版本：支持 .NET Framework 及 .NET Core / .NET 6 / .NET 8
IDE：Visual Studio（社区版及以上版本均可）
数据库：本文示例使用 SQL Server Express，采用 Windows 身份验证（也可改为 SQL 身份验证）
必需库：
- Spire.XLS for .NET（NuGet 安装：Install-Package Spire.XLS）
- Microsoft.Data.SqlClient（SQL Server 访问驱动，NuGet 安装）

示例数据库

以下 SQL 脚本在 SQL Server Express 中创建一个 Employees 表并插入测试数据：

CREATE TABLE Employees (Id INT PRIMARY KEY IDENTITY,Name NVARCHAR(100) NOT NULL,Department NVARCHAR(50) NOT NULL,Position NVARCHAR(50),HireDate DATE NOT NULL,Salary DECIMAL(10, 2) NOT NULL,IsFullTime BIT NOT NULL
);INSERT INTO Employees (Name, Department, Position, HireDate, Salary, IsFullTime) VALUES
(N'张伟', N'人力资源部', N'人事经理', '2018-05-01', 5500.00, 1),
(N'李强', N'信息技术部', N'软件工程师', '2020-09-15', 7200.50, 1),
(N'王芳', N'财务部', N'会计', '2019-11-20', 6300.75, 0),
(N'陈丽', N'市场部', N'内容专员', '2021-02-10', 4800.00, 1);

如果使用 MySQL 或 SQLite，只需调整 SQL 语法与连接字符串，整体导出逻辑不变。

用 C# 将数据库数据导出到 Excel

1. 建立数据库连接

以 SQL Server Express 为例，使用 SqlConnection 建立连接：

string connectionString = @"Data Source=YourServer\SQLEXPRESS;Initial Catalog=YourDatabaseName;Integrated Security=True;";

Windows 身份验证：Integrated Security=True
SQL 身份验证： User ID=yourUsername;Password=yourPassword;Encrypt=True;TrustServerCertificate=True

2. 将数据读取到 DataTable

使用 SqlDataAdapter 执行查询并填充 DataTable：

using System.Data;
using Microsoft.Data.SqlClient;DataTable dataTable = new DataTable();
using (SqlConnection conn = new SqlConnection(connectionString))
{conn.Open();string query = "SELECT * FROM Employees";using (SqlDataAdapter adapter = new SqlDataAdapter(query, conn)){adapter.Fill(dataTable);}
}

3. 使用 Spire.XLS 导出到 Excel

using Spire.Xls;Workbook workbook = new Workbook();
workbook.Worksheets.Clear();
Worksheet sheet = workbook.Worksheets.Add("Employees");// 从第 1 行第 1 列插入 DataTable 数据，并包含列标题
sheet.InsertDataTable(dataTable, true, 1, 1);// 保存为 Excel 2013 格式
workbook.SaveToFile("Employees.xlsx", ExcelVersion.Version2013);

核心方法：

InsertDataTable(DataTable table, bool columnHeaders, int firstRow, int firstColumn)
- columnHeaders=true 表示将列名写入第一行
- firstRow / firstColumn 定义数据起始位置（基于 1 索引）
SaveToFile：可保存为 .xlsx、.xls、.csv 等格式，也可保存到流中

优化 Excel 格式（可选但推荐）

导出数据后，可以通过以下方式提高可读性：

// 表头样式
sheet.Rows[0].Style.Font.IsBold = true;
sheet.Rows[0].Style.Font.Size = 14;
sheet.Rows[0].Style.HorizontalAlignment = HorizontalAlignType.Center;
sheet.Rows[0].Style.Color = System.Drawing.Color.LightGray;// 数据行样式
for (int i = 1; i < sheet.Rows.Count(); i++)
{var dataRow = sheet.Rows[i];dataRow.Style.Font.Size = 12;dataRow.Style.HorizontalAlignment = HorizontalAlignType.Left;
}// 设置全局字体
sheet.AllocatedRange.Style.Font.FontName = "微软雅黑";// 添加边框
sheet.AllocatedRange.BorderAround(LineStyleType.Thin, System.Drawing.Color.Black);
sheet.AllocatedRange.BorderInside(LineStyleType.Medium, System.Drawing.Color.Black);// 自动调整列宽
sheet.AllocatedRange.AutoFitColumns();

其他数据读取方式

除了 DataTable 之外，你还可以：

使用 Entity Framework

var employees = dbContext.Employees.ToList();

然后将集合转换为 DataTable 或逐行写入 Excel。
调用存储过程

SqlCommand cmd = new SqlCommand("GetEmployees", conn);
cmd.CommandType = CommandType.StoredProcedure;

读取 SQLite / MySQL / Oracle 只需更换连接类型和驱动（Microsoft.Data.Sqlite、MySql.Data 等），其余导出逻辑相同。

常见问题与解决方法

问题	可能原因与解决方案
Excel 文件为空	检查 DataTable 是否在导出前已正确填充
文件无法保存	确认保存路径存在且有写入权限
无法连接数据库	检查服务器是否启动、连接字符串是否正确
特殊字符乱码	数据库列类型应使用 NVARCHAR，Excel 需使用支持 Unicode 的字体
身份验证失败	Windows 身份验证用 Integrated Security=True，SQL 身份验证需提供用户名与密码