萬盛學電腦網

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

FSO CreateTextFile 方法完整參考:參數詳解、編碼控制、覆蓋模式、錯誤處理最佳實踐

FileSystemObject.CreateTextFile 方法權威指南

CreateTextFile 是 FSO 創建文本文件的核心方法,支持覆蓋控制、Unicode/ASCII 編碼選擇。本文詳細解析各參數、返回對象方法、常見錯誤與生產級封裝。

語法簽名

object.CreateTextFile(filename[, overwrite[, unicode]])

參數詳細說明

參數類型必選說明
objectObject是FileSystemObject 或 Folder 對象
filenameString是文件完整物理路徑(建議用 Server.MapPath 轉換)
overwriteBoolean否True=覆蓋已存在文件,**False(默認)**=文件存在時拋錯
unicodeBoolean否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

編碼選擇指南

生產級封裝:安全寫入文本文件

Function SafeWriteTextFile(filePath, content, charset, append)
    Dim fso, ts, fullPath, mode
    On Error Resume Next
    
    fullPath = Server.MapPath(filePath)
    Set fso = CreateObject("Scripting.FileSystemObject")
    
    ' 確保目錄存在
    Dim dir : dir = fso.GetParentFolderName(fullPath)
    If Not fso.FolderExists(dir) Then fso.CreateFolder(dir)
    
    If append Then
        ' 追加模式
        Set ts = fso.OpenTextFile(fullPath, 8, True, IIf(charset = "unicode", -1, 0))
        ' 8=ForAppending, -1=TristateTrue(Unicode), 0=TristateFalse(ASCII)
    Else
        ' 覆蓋模式:使用 ADODB.Stream 精確控制編碼
        Dim stream : Set stream = CreateObject("ADODB.Stream")
        stream.Type = 2 : stream.Mode = 3 : stream.Open
        stream.Charset = charset Or "UTF-8"
        stream.WriteText content
        stream.SaveToFile fullPath, 2  ' 2=adSaveCreateOverWrite
        stream.Close
        Set stream = Nothing
        SafeWriteTextFile = (Err.Number = 0)
        Set fso = Nothing
        Exit Function
    End If
    
    If Err.Number <> 0 Then
        SafeWriteTextFile = False
        Err.Clear
    Else
        ts.Write content
        ts.Close
        SafeWriteTextFile = True
    End If
    Set ts = Nothing
    Set fso = Nothing
End Function

' 用法
SafeWriteTextFile "/data/export.txt", "內容", "UTF-8", False

常見錯誤與排查

場景unicode 參數備註
純英文/ASCII 日誌False (默認)文件體積小、兼容性最好
包含中文/多語言文本TrueUTF-16LE,無 BOM 可能導致某些工具誤判
JSON/XML 配置文件True標準要求 UTF-8/16,FSO 僅支持 UTF-16LE
需 UTF-8 無 BOM不可用改用 ADODB.Stream (Charset="UTF-8")
錯誤碼/描述原因解決
800a003e: File already existsoverwrite=False 且文件已存在設置 True 或先刪除
800a0046: Permission deniedIIS 用戶無寫入權限授予 IUSR/應用程序池身份寫入權限
800a0035: File not found目錄不存在遞歸創建目錄
800a005b: Object variable not setCreateObject 失敗檢查 FSO 組件註冊、權限
中文亂碼編碼不匹配統一使用 ADODB.Stream + UTF-8

最佳實踐清單

  1. **統一用 ADODB.Stream** 寫入文本,精確控制編碼、BOM、換行符,避免 FSO 編碼局限。
  2. **路徑參數化**:業務代碼傳相對虛擬路徑,工具函數內部 Server.MapPath。
  3. **異常安全**:On Error Resume Next + 檢查 Err.Number + Finally 模式關閉流/釋放對象。
  4. **並發寫入**:單文件追加需鎖(Application.Lock/文件鎖/隊列),否則數據交織丟失。
  5. **日誌輪轉**:按日期/大小分割,避免單文件過大導致讀寫性能下降。

文件操作看似簡單,編碼、權限、並發、異常處理環環相扣,封裝健壯的工具庫是專業團隊的標配。

copyright © 萬盛學電腦網 all rights reserved