
在 C# 中將 DataTable 導出為 Excel 文件,是 .NET 開發中常見的任務,廣泛應用於報表生成、日誌導出、系統間數據共享等場景。通過使用獨立的組件庫,開發者可以輕鬆將 DataTable 數據寫入 Excel 文件,並應用格式設置,生成專業、可直接使用的文檔,無需複雜配置或依賴第三方辦公軟件。
本文將介紹如何使用 Spire.XLS for .NET 將 DataTable 導出為 Excel(.xlsx/.xls)文件,包含數據創建、導出保存、格式設置等實用步驟。
Spire.XLS for .NET試用下載,請聯繫Spire官方授權代理商慧都科技
歡迎加入Spire技術交流Q羣(125237868),與更多小夥伴一起提升文檔開發技能~
安裝和配置 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。
Spire.XLS for .NET試用下載,請聯繫Spire官方授權代理商慧都科技
歡迎加入Spire技術交流Q羣(125237868),與更多小夥伴一起提升文檔開發技能~
分步操作: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 報表。
Spire.XLS for .NET試用下載,請聯繫Spire官方授權代理商慧都科技
歡迎加入Spire技術交流Q羣(125237868),與更多小夥伴一起提升文檔開發技能~
常見問答(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 行。