C# 學生管理系統：使用 NPOI 導出 Excel 無需安裝 Office/WPS

為何選擇 NPOI？

• **純 .NET 實現**，無需機器安裝 Excel 或 WPS。
• 支援 .xls (HSSF) 與 .xlsx (XSSF) 格式。
• 效能優於 COM Interop，適合伺服器端批量導出。
• 開源免費（Apache 2.0），NuGet 直接安裝。

NuGet 安裝

Install-Package NPOI
// 或 .NET Core CLI
dotnet add package NPOI

完整導出範例

using NPOI.HSSF.UserModel;   // .xls
using NPOI.XSSF.UserModel;   // .xlsx
using NPOI.SS.UserModel;
using System.Data;
using System.IO;

public byte[] ExportStudentsToExcel(DataTable dt, bool xlsx = true) {
    IWorkbook workbook = xlsx ? (IWorkbook)new XSSFWorkbook() : new HSSFWorkbook();
    ISheet sheet = workbook.CreateSheet(\"學生名單\");

    // 樣式：表頭加粗、置中、邊框
    ICellStyle headerStyle = workbook.CreateCellStyle();
    IFont headerFont = workbook.CreateFont(); headerFont.IsBold = true; headerStyle.SetFont(headerFont);
    headerStyle.Alignment = HorizontalAlignment.Center;
    headerStyle.BorderBottom = BorderStyle.Thin; headerStyle.BorderTop = BorderStyle.Thin;
    headerStyle.BorderLeft = BorderStyle.Thin; headerStyle.BorderRight = BorderStyle.Thin;

    ICellStyle dataStyle = workbook.CreateCellStyle();
    dataStyle.BorderBottom = BorderStyle.Thin; dataStyle.BorderTop = BorderStyle.Thin;
    dataStyle.BorderLeft = BorderStyle.Thin; dataStyle.BorderRight = BorderStyle.Thin;

    // 寫入表頭
    IRow headerRow = sheet.CreateRow(0);
    for (int c = 0; c < dt.Columns.Count; c++) {
        ICell cell = headerRow.CreateCell(c);
        cell.SetCellValue(dt.Columns[c].ColumnName);
        cell.CellStyle = headerStyle;
    }

    // 寫入資料
    for (int r = 0; r < dt.Rows.Count; r++) {
        IRow row = sheet.CreateRow(r + 1);
        for (int c = 0; c < dt.Columns.Count; c++) {
            ICell cell = row.CreateCell(c);
            object val = dt.Rows[r][c];
            if (val is DateTime) cell.SetCellValue((DateTime)val);
            else if (val is double || val is float || val is decimal) cell.SetCellValue(Convert.ToDouble(val));
            else if (val is int || val is long) cell.SetCellValue(Convert.ToInt64(val));
            else cell.SetCellValue(val?.ToString() ?? \"\");
            cell.CellStyle = dataStyle;
        }
    }

    // 自動欄寬
    for (int c = 0; c < dt.Columns.Count; c++) sheet.AutoSizeColumn(c);

    using (MemoryStream ms = new MemoryStream()) {
        workbook.Write(ms);
        return ms.ToArray();
    }
}

// 呼叫範例（WinForm/Web API 均適用）
// byte[] excelBytes = ExportStudentsToExcel(dataTable);
// File.WriteAllBytes(\"students.xlsx\", excelBytes); // 或回傳 FileStreamResult

常見問題與解決

參考資源

• 官方範例：NPOI Examples
• 中文教學：NPOI 導出 Excel 完整教程

總結

**NPOI 是 C# 導出 Excel 的最佳選擇**：無依賴、跨平台、功能完整。配合 DataTable 或實體列表，十幾行代碼即可生成專業格式試算表。