萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP 程式設計

ASP 產生 UTF-8 編碼檔案:突破 FileSystemObject 限制,改用 ADODB.Stream

問題背景

傳統 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
%>

關鍵屬性與常數說明

編碼知識補充: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
屬性/方法值/常數說明
.Type2 (adTypeText)文字模式;1=adTypeBinary 二進位
.Charset"utf-8"支援 "utf-16", "gb2312", "big5" 等
.Position.Size移至串流末尾,達到附加效果
.SaveToFile2 (adSaveCreateOverWrite)1=adSaveCreateNotExist(不覆寫)