方案背景
經典 ASP 環境下無原生 PDF 生成庫,常見變通方案:利用安裝於服務器的 Microsoft Excel ODBC 驅動,通過 ADO 讀取 Excel 文件 (或命名範圍) 作為數據源,生成 HTML 表格,再由客戶端瀏覽器「另存為 PDF」或打印到 PDF 虛擬打印機。本文解析該完整腳本邏輯。
核心模塊職責
- 驅動檢測:
CheckXlDriver 嘗試連接 Excel 驅動,捕獲特定錯誤碼 (-5036) 判斷可用性。
- 連接管理:
GetConnection 創建 ADODB.Connection 連接 Excel 文件。
- UI 輔助:
OptionTag/IsChecked/BookOptions/NamedRangeOptions 生成下拉選單,選擇 Excel 文件與工作表/命名範圍。
- 數據呈現:
DataTable 執行 SQL 查詢 (SELECT * FROM [SheetName$]) 生成 HTML 表格。
關鍵代碼片段
1. Excel 驅動檢測
Sub CheckXlDriver()
On Error Resume Next
Dim vConnString, oConn, oErr
vConnString = "DRIVER={Microsoft Excel Driver (*.xls)};DBQ=NUL:"
Set oConn = CreateObject("ADODB.Connection")
oConn.Open vConnString
For Each oErr In oConn.Errors
' -5036: "文件創建失敗" 實際意味著驅動正常但 DBQ 無效
If oErr.NativeError = -5036 Then Exit Sub
Next
' 遍歷錯誤集合輸出診斷信息
Response.Write "MDAC 驅動不可用: " & Hex(Err.Number) & " " & Err.Description & "
"
For Each oErr In oConn.Errors
Response.Write Hex(oErr.Number) & " " & oErr.NativeError & " " & oErr.Description & "
"
Next
Response.End
End Sub
2. 動態發現 Excel 文件與命名範圍
Function BookOptions(vXlFile)
Dim vServerFolder, oFs, oFolder, oFile, vSelected
vServerFolder = Server.MapPath(".")
Set oFs = Server.CreateObject("Scripting.FileSystemObject")
Set oFolder = oFs.GetFolder(vServerFolder)
For Each oFile In oFolder.Files
If oFile.Type = "Microsoft Excel Worksheet" Then
vSelected = (oFile.Name = vXlFile)
BookOptions = BookOptions & OptionTag(oFile.Name, vSelected)
End If
Next
End Function
Function NamedRangeOptions(oConn, vXlRange, vTableType)
Dim oSchemaRs, vSelected
NamedRangeOptions = OptionTag(Empty, Empty)
If TypeName(oConn) = "Connection" Then
Set oSchemaRs = oConn.OpenSchema(adSchemaTables) ' 獲取架構信息
Do While Not oSchemaRs.EOF
If oSchemaRs("TABLE_TYPE") = vTableType Then ' "TABLE" 或 "VIEW"
vSelected = (oSchemaRs("TABLE_NAME") = vXlRange)
NamedRangeOptions = NamedRangeOptions & OptionTag(oSchemaRs("TABLE_NAME"), vSelected)
End If
oSchemaRs.MoveNext
Loop
End If
End Function
3. 生成 HTML 數據表格
Function DataTable(oConn, vXlRange, vXlHasheadings)
On Error Resume Next
Const DB_E_ERRORSINCOMMAND = &H80040E14
Dim oRs, oField, vThTag, vThEndTag
If vXlHasheadings Then
vThTag = "| ": vThEndTag = " | "
Else
vThTag = "": vThEndTag = " | "
End If
DataTable = ""
If TypeName(oConn) = "Connection" Then
' 查詢工作表/命名範圍: [Sheet1$] 或 [NamedRange]
Set oRs = oConn.Execute("[" & vXlRange & "]")
If oConn.Errors.Count > 0 Then
' 錯誤處理:範圍不存在、語法錯誤等
For Each oConnErr In oConn.Errors
If oConnErr.Number = DB_E_ERRORSINCOMMAND Then
DataTable = DataTable & "| 範圍不存在: | " & vXlRange & " |
"
Else
DataTable = DataTable & "| " & oConnErr.Description & " |
"
End If
Next
Else
' 表頭
DataTable = DataTable & ""
For Each oField In oRs.Fields
DataTable = DataTable & vThTag & Server.HTMLEncode(oField.Name) & vThEndTag
Next
DataTable = DataTable & "
"
' 數據行 (代碼截斷,原邏輯續寫循環輸出 oRs.GetRows 或 MoveNext)
' ...
End If
End If
DataTable = DataTable & "
"
End Function
架構局限與風險
| 問題 | 影響 |
| 依賴服務端安裝 Office/Excel 驅動 | 授權成本、版本兼容性、64位環境驅動缺失 |
| Excel 進程易殭屍、佔用大量內存/CPU | 併發極低、服務器不穩定、需定期重啟 |
| 非真正 PDF 生成,僅 HTML 列表 | 依賴客戶端打印/另存,格式不可控、無水印/加密/書籤 |
| SQL 注入風險 | vXlRange 直接拼接進 SQL,若來自用戶輸入極危險 |
| 錯誤處理依賴 On Error Resume Next | 難以定位具體失敗點,調試困難 |
現代化替代方案對比
| 方案 | 語言/平台 | 核心庫/工具 | 優勢 |
| 服務端直接生成 PDF | Python | WeasyPrint, ReportLab, fpdf2, pdfkit(wkhtmltopdf) | 無 Office 依賴、純代碼控制樣式、高併發、支持 CSS/JS |
| 服務端直接生成 PDF | .NET Core | QuestPDF, PdfSharp, IronPDF, DinkToPdf | 強類型、高性能、原生部署 |
| 服務端直接生成 PDF | Node.js | Puppeteer, Playwright, pdfkit | Chrome 無頭瀏覽器渲染、完美支持現代 CSS/JS |
| 報表服務 | 跨平台 | JasperReports, Seal Report, Metabase | 可視化設計、多數據源、調度分發、導出多格式 |
| 雲端 API | 無關 | DocRaptor, PDFShift, CloudConvert | 零維護、按量付費、高可用 |
遷移路徑建議
- 數據源解耦:將業務數據從 Excel 遷移至關係型數據庫 (SQL Server/PostgreSQL/MySQL) 或結構化存儲 (CSV/Parquet/JSON)。
- 模板化報表:設計 Jinja2/Handlebars/Razor 模板,分離數據與呈現。
- 選型生成引擎:根據技術棧選擇上述現代庫,優先考慮
WeasyPrint (Python) 或 Puppeteer (Node) 以獲得最佳 CSS 支持。
- 漸進式遷移:新報表用新方案,舊報表逐步重寫,期間共存。
總結
ASP + Excel ODBC + HTML 表格方案是特定歷史條件下的權宜之計,核心價值在於「利用現有 Excel 文件作為數據源快速產出可打印報表」。現代架構應將數據源標準化、報表模板代碼化、生成引擎服務化,徹底擺脫桌面辦公組件依賴,實現高可用、高併發、可審計的文檔生成服務。