CreateTextFile 是 FSO 創建文本文件的核心方法,支持覆蓋控制、Unicode/ASCII 編碼選擇。本文詳細解析各參數、返回對象方法、常見錯誤與生產級封裝。
object.CreateTextFile(filename[, overwrite[, unicode]])
| 參數 | 類型 | 必選 | 說明 |
|---|---|---|---|
| object | Object | 是 | FileSystemObject 或 Folder 對象 |
| filename | String | 是 | 文件完整物理路徑(建議用 Server.MapPath 轉換) |
| overwrite | Boolean | 否 | True=覆蓋已存在文件,**False(默認)**=文件存在時拋錯 |
| unicode | Boolean | 否 | True=創建 Unicode (UTF-16LE) 文件,**False(默認)**=ASCII/ANSI (系統代碼頁) |
TextStreamObject 文本流對象,提供以下核心方法:
Write(string):寫入字符串(無換行)WriteLine(string):寫入字符串 + 換行符WriteBlankLines(lines):寫入空行Close():關閉流,**必須調用**確保數據刷新到磁盤屬性:AtEndOfStream、AtEndOfLine、Column、Line。
Dim fso, ts
Set fso = CreateObject("Scripting.FileSystemObject")
' 1. 創建/覆蓋 ANSI 文件
Set ts = fso.CreateTextFile(Server.MapPath("/logs/app.log"), True, False)
ts.WriteLine "[" & Now() & "] Application started"
ts.Close
' 2. 創建 Unicode 文件(支持中文無亂碼)
Set ts = fso.CreateTextFile(Server.MapPath("/data/config.json"), True, True)
ts.Write "{""name"":""測試"",""version"":1}"
ts.Close
' 3. 追加模式:需先打開再定位(CreateTextFile 不支持追加)
' 改用 OpenTextFile(filename, 8, True) ' 8=ForAppending, True=創建
Set ts = fso.OpenTextFile(Server.MapPath("/logs/app.log"), 8, True)
ts.WriteLine "[" & Now() & "] Request processed"
ts.Close
Set fso = Nothing
| 場景 | unicode 參數 | 備註 |
|---|---|---|
| 純英文/ASCII 日誌 | False (默認) | 文件體積小、兼容性最好 |
| 包含中文/多語言文本 | True | UTF-16LE,無 BOM 可能導致某些工具誤判 |
| JSON/XML 配置文件 | True | 標準要求 UTF-8/16,FSO 僅支持 UTF-16LE |
| 需 UTF-8 無 BOM | 不可用 | 改用 ADODB.Stream (Charset="UTF-8") |
| 錯誤碼/描述 | 原因 | 解決 |
|---|---|---|
| 800a003e: File already exists | overwrite=False 且文件已存在 | 設置 True 或先刪除 |
| 800a0046: Permission denied | IIS 用戶無寫入權限 | 授予 IUSR/應用程序池身份寫入權限 |
| 800a0035: File not found | 目錄不存在 | 遞歸創建目錄 |
| 800a005b: Object variable not set | CreateObject 失敗 | 檢查 FSO 組件註冊、權限 |
| 中文亂碼 | 編碼不匹配 | 統一使用 ADODB.Stream + UTF-8 |
Server.MapPath。On Error Resume Next + 檢查 Err.Number + Finally 模式關閉流/釋放對象。文件操作看似簡單,編碼、權限、並發、異常處理環環相扣,封裝健壯的工具庫是專業團隊的標配。