CopyFile 方法

將一個或多個文件從某位置復制到另一位置。

object.CopyFile source, destination[, overwrite]

參數

object

必選項。應為 FileSystemObject 對象的名稱。

source

必選項。表示指定文件的字符串。要復制一個或多個文件時，文件名中可以有通配符。

destination

必選項。表示目標位置的字符串，從 source 復制文件到該位置。不允許用通配符。

overwrite

可選項。Boolean 值表明是否覆蓋現有文件。如果是 True，則覆蓋文件；如果是 False，則不覆蓋現有文件。默認值是 True。要注意，無論 overwrite 設置為何值，只要設置 destination 為只讀屬性，CopyFile 操作就無法完成。

說明

僅能在 source 參數的路徑最后一個組成部分中使用通配符。例如，可以使用：

FileSystemObject.CopyFile "c:/mydocuments/letters/*.doc", "c:/tempfolder/"

但是，不能使用：

FileSystemObject.CopyFile "c:/mydocuments/*/R1???97.xls", "c:/tempfolder"

如果 source 包含通配符或 destination 以路徑分隔符 (/) 結束，則假定 destination 是現有文件夾，復制匹配文件到該文件夾。否則，假定 destination 為要創建的文件。在任一種情況下，復制單個文件時，會出現以下三種情況。

• 如果 destination 不存在，則復制 source。這是通常會發生的情況。
• 如果 destination 是已經存在的文件，當 overwrite 為 False 時會出現錯誤。否則，復制 source 覆蓋現有文件。
• 如果 destination 是目錄，則會出現錯誤。

如果 source 使用通配符，但并沒有相匹配的文件時，則會出現錯誤。CopyFile 方法在遇到出現的第一個錯誤時停止。該方法不會撤消錯誤發生前所作的任何更改。