CopyFolder 方法
將檔案夾從某位置遞迴複製到另一位置。
object.CopyFolder source, destination[, overwrite]
參數
object
必選項。應為 FileSystemObject 對象的名稱。
source
必選項。表示指定檔案夾的字串。要複製一個或多個檔案夾時,可使用萬用字元。
destination
必選項。表示目標位置的字串,複製 source 檔案夾或子檔案夾到該位置。不允許用萬用字元。
overwrite
可選項。Boolean 值表明是否覆蓋現有檔案夾。如果為 True,則覆蓋檔案;如果為 False,則不覆蓋檔案。預設值是 True。
說明
僅能在 source 參數的路徑最後一個組成部分中使用萬用字元。例如,可以使用:
FileSystemObject.CopyFolder "c:\mydocuments\letters\*", "c:\tempfolder\"
但是,不可以使用:
FileSystemObject.CopyFolder "c:\mydocuments\*\*", "c:\tempfolder\"
如果 source 包含萬用字元或 destination 以路徑分隔字元 (\) 結束,則假定 destination 是現有檔案夾,在該檔案夾中複製匹配檔案夾或子檔案夾。否則,假定 destination 是要建立的檔案夾。在任一種情況下,複製單個檔案夾時,會發生如下四種情況。
- 如果 destination 不存在,則複製 source 檔案夾和其所有內容。這是通常會發生的情況。
- 如果 destination 是已經存在的檔案,則出現錯誤。
- 如果 destination 是目錄,則複製檔案夾和其中的所有內容。如果在 destination 已經存在 source 包含的檔案,且 overwrite 為 False,則會出現錯誤。否則,複製該檔案覆蓋現有檔案。
- 如果 destination 是唯讀目錄,在向該目錄複寫現有唯讀檔案,且 overwrite 為 False 時,就會出現錯誤。
如果 source 使用萬用字元,但沒有匹配檔案時,也會出現錯誤。
CopyFolder 方法在遇到出現的第一個錯誤時停止。該方法不會撤消錯誤發生前所作的任何更改。