C# 將 SQL Server 資料匯出至 Excel 完整範例

核心邏輯

1. 使用 SqlDataAdapter 填充 DataSet。
2. 啟動 Excel Application (COM 自動化)。
3. 寫入欄位標題 (Row 1)。
4. 逐列寫入資料。
5. 設定 Visible = true 顯示結果 (或背景存檔)。

完整程式碼

using System;
using System.Data;
using System.Data.SqlClient;
using Excel = Microsoft.Office.Interop.Excel;

public class SqlToExcelExporter {
    private readonly string _connStr = @"Server=PXGD2;Database=pingxiang;Uid=sa;Pwd=;";

    public DataTable GetData() {
        using (var conn = new SqlConnection(_connStr))
        using (var adapter = new SqlDataAdapter(
            "SELECT username AS 用戶名, catalyst_port AS 占用端口, home_address AS 住宅地址, " +
            "ip_address AS IP地址, phone AS 電話, addtime AS 開通日期 " +
            "FROM userinfo WHERE catalyst_port = 1 OR catalyst_port = 2 ORDER BY ip_address DESC", conn)) {
            var ds = new DataSet();
            adapter.Fill(ds, "Customer");
            return ds.Tables[0];
        }
    }

    public void ExportToExcel() {
        var table = GetData();
        var excel = new Excel.Application();
        try {
            excel.Workbooks.Add(true); // 新增活頁簿
            int rowIdx = 1, colIdx = 0;

            // 寫入標題
            foreach (DataColumn col in table.Columns) {
                excel.Cells[1, ++colIdx] = col.ColumnName;
            }

            // 寫入資料
            foreach (DataRow row in table.Rows) {
                rowIdx++;
                colIdx = 0;
                foreach (DataColumn col in table.Columns) {
                    excel.Cells[rowIdx, ++colIdx] = row[col.ColumnName]?.ToString() ?? "";
                }
            }

            excel.Visible = true; // 顯示 Excel 視窗
            // 若需背景存檔：excel.ActiveWorkbook.SaveAs(path); excel.Quit();
        } finally {
            // 注意：COM 物件需手動釋放 (Marshal.ReleaseComObject)，此處省略
        }
    }
}

效能與替代方案

生產環境強烈建議改用 EPPlus 或 ClosedXML，避免伺服器安裝 Office 且大幅提升效能。

關鍵注意事項

• 參數化查詢防注入 (本範例為靜態 SQL)。
• 大量資料分批寫入或使用 Range.Value = object[,] 陣列一次寫入。
• COM 物件釋放：Marshal.ReleaseComObject 釋放 Worksheet、Workbook、Application，並呼叫 GC.Collect()。
• Excel 行數限制：.xls 65,536 列，.xlsx 1,048,576 列。