功能特色
- 支援多工作表、自訂標題列、資料來源可為二維陣列或 Recordset。
- 封裝 Excel.Application 建立、資料填入、儲存、釋放全流程。
- 內建逾時保護、錯誤處理、耗時統計。
- 可另存為檔案或直接串流下載。
類別架構概覽
Class CreateExcel
' 屬性
Public SavePath ' 儲存路徑 (虛擬或實體)
Public SheetName ' 工作表名稱 (字串或陣列)
Public SheetTitle ' 標題列 (字串或陣列)
Public Data ' 二維陣列資料
Public TitleFirstLine ' 第一列是否為標題
Public ReadPath ' 讀取範本路徑
Public CreateType ' 1=新建, 2=開啟範本
' 唯讀屬性
Public Property Get UsedTime ' 產生耗時 (ms)
Public Property Get Code ' 內部用
' 方法
Public Sub AddDBData(rs, fields, sheetName, title, autoHeader)
Public Sub AddData(arr, hasTitle, sheetName, title)
Public Sub AddTplData(arr, sheetName) ' 依範本位置填入
Public Sub Create() ' 執行產出
Private Sub Class_Initialize()
Private Sub Class_Terminate() ' 確實釋放 Excel 程序
End Class
快速上手範例
<!--#include file="CreateExcel.asp"-->
<%
Dim xl, rs, conn
Set xl = New CreateExcel
xl.SavePath = "/exports/report_" & Year(Now) & Right("0"&Month(Now),2) & ".xls"
xl.SheetName = "銷售明細"
xl.SheetTitle = "日期,客戶,金額,備註"
xl.TitleFirstLine = True
Set conn = Server.CreateObject("ADODB.Connection")
conn.Open "Provider=SQLOLEDB;Data Source=.;Initial Catalog=ERP;UID=sa;PWD=xxx"
Set rs = conn.Execute("SELECT Convert(varchar(10),OrderDate,111),CustName,Amount,Memo FROM Orders WHERE OrderDate>='2024-01-01'")
xl.AddDBData rs, "OrderDate,CustName,Amount,Memo", "銷售明細", "銷售明細", True
xl.Create()
Response.Write "匯出完成,耗時 " & xl.UsedTime & " ms,檔案:" & xl.SavePath
%>
部署注意事項 (關鍵)
- 伺服器必須安裝 Microsoft Excel (或至少 Excel Viewer + 相容性套件)。
- 執行
DCOMCNFG,找到 Microsoft Excel Application,右鍵內容 → 安全性 → 啟動與啟動權限、存取權限、設定值 全部選 自訂 → 編輯 → 加入 Everyone 並給予 全部權限 (Local Launch, Local Activation, Local Access, Remote Access)。
- 應用程式集區身分識別建議使用具備桌面互動權限的帳號,或勾選「載入使用者設定檔」。
- 大量並發匯出時,Excel 程序會大量佔用記憶體/CPU,建議改用 OpenXML SDK (ASP.NET) 或 NPOI 純元件方案,避免啟動 Excel 進程。
常見錯誤排查
| 錯誤 | 原因 | 對策 |
| 800A03EC / 80070005 | DCOM 權限不足 | 依上述步驟給予 Everyone 完整權限 |
| Excel 殭屍進程 | Class_Terminate 未正確釋放 | 確認 Terminate 中 Quit + Set Nothing,必要時用排程清理 |
| 中文亂碼 | 儲存編碼不一致 | 確保檔案儲存為 Unicode (xl.SavePath 以 .xls 為主,若需 .xlsx 需 Office 2007+) |