問題背景
傳統 Scripting.FileSystemObject 的 CreateTextFile 方法僅支援 ASCII (Unicode=False) 或 UTF-16 LE (Unicode=True),無法直接建立 UTF-8 編碼檔案。這對需產生 sitemap.xml、rss.xml、JSON API 回應等現代標準格式極為不便。
解決方案:ADODB.Stream
ADODB.Stream 物件支援完整字元集控制,是 ASP 產生 UTF-8 檔案的標準作法。
核心程式碼
<%
Dim objStream, strContent, savePath
strContent = "<urlset>...</urlset>"
savePath = Server.MapPath("/sitemap.xml")
Set objStream = Server.CreateObject("ADODB.Stream")
With objStream
.Type = 2 ' adTypeText (文字模式)
.Charset = "utf-8" ' 關鍵:指定 UTF-8 編碼
.Open
.Position = .Size ' 移至尾端 (Append 效果)
.WriteText strContent
.SaveToFile savePath, 2 ' 2 = adSaveCreateOverWrite (覆寫)
.Close
End With
Set objStream = Nothing
Response.Write "UTF-8 檔案建立完成:" & savePath
%>
關鍵屬性與常數說明
| 屬性/方法 | 值/常數 | 說明 |
| .Type | 2 (adTypeText) | 文字模式;1=adTypeBinary 二進位 |
| .Charset | "utf-8" | 支援 "utf-16", "gb2312", "big5" 等 |
| .Position | .Size | 移至串流末尾,達到附加效果 |
| .SaveToFile | 2 (adSaveCreateOverWrite) | 1=adSaveCreateNotExist(不覆寫) |
編碼知識補充:ASCII / Unicode / UTF-8
- ASCII:1 位元組,0-127,僅英數符號。
- Unicode (字元集):為全球字元分配唯一碼位,如 'A'=U+0041,'中'=U+4E2D。
- UTF-16 (UCS-2):固定 2/4 位元組編碼 Unicode,Windows 內部常用。
- UTF-8:變長編碼,ASCII 相容 (1 位元組),中文 3 位元組,Emoji 4 位元組,網頁傳輸標準。
關鍵優勢:純 ASCII 內容在 UTF-8 下位元組序列完全相同,零成本相容舊系統。
進階應用:附加寫入 (Append) 與二進位輸出
附加模式寫入 Log
Sub AppendLogUtf8(logPath, logLine)
Dim stm
Set stm = Server.CreateObject("ADODB.Stream")
With stm
.Type = 2: .Charset = "utf-8": .Open
.Position = .Size
.WriteText logLine & vbCrLf
.SaveToFile logPath, 2
.Close
End With
Set stm = Nothing
End Sub
輸出二進位檔案 (圖片、PDF、Excel)
Response.ContentType = "application/octet-stream"
Response.AddHeader "Content-Disposition", "attachment; filename=data.xlsx"
Dim stm
Set stm = Server.CreateObject("ADODB.Stream")
stm.Type = 1 ' adTypeBinary
stm.Open
stm.LoadFromFile Server.MapPath("/files/report.xlsx")
Response.BinaryWrite stm.Read
stm.Close
Set stm = Nothing
常見錯誤與除錯
- 亂碼:確認 .asp 原始檔儲存為 UTF-8 with BOM 或系統預設編碼一致,字串常值才會正確解碼。
- BOM 問題:
ADODB.Stream 寫入 UTF-8 不會自動加入 BOM。若下游系統要求 BOM,需手動 .WriteText Chr(&hFEFF) & content。
- 權限:
IUSR / 應用程式集區身分需具備目標資料夾寫入權限。
- 大檔案:
ADODB.Stream 全載入記憶體,超大檔案建議分塊處理或改用元件。
總結
放棄 FileSystemObject.CreateTextFile,改用 ADODB.Stream 設定 .Charset = "utf-8",即可在經典 ASP 中優雅產生符合現代標準的 UTF-8 檔案。同技巧亦適用於二進位檔案讀寫、Log 附加、編碼轉換等進階場景。
copyright ©
萬盛學電腦網 all rights reserved