CopyFile 方法

將一個(gè)或多個(gè)文件從某位置復(fù)制到另一位置。

object.CopyFile source, destination[, overwrite]

參數(shù)

object

必選項(xiàng)。應(yīng)為 FileSystemObject 對象的名稱。

source

必選項(xiàng)。表示指定文件的字符串。要復(fù)制一個(gè)或多個(gè)文件時(shí)，文件名中可以有通配符。

destination

必選項(xiàng)。表示目標(biāo)位置的字符串，從 source 復(fù)制文件到該位置。不允許用通配符。

overwrite

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

說明

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

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

但是，不能使用：

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

如果 source 包含通配符或 destination 以路徑分隔符 (\) 結(jié)束，則假定 destination 是現(xiàn)有文件夾，復(fù)制匹配文件到該文件夾。否則，假定 destination 為要創(chuàng)建的文件。在任一種情況下，復(fù)制單個(gè)文件時(shí)，會出現(xiàn)以下三種情況。

• 如果 destination 不存在，則復(fù)制 source。這是通常會發(fā)生的情況。
• 如果 destination 是已經(jīng)存在的文件，當(dāng) overwrite 為 False 時(shí)會出現(xiàn)錯(cuò)誤。否則，復(fù)制 source 覆蓋現(xiàn)有文件。
• 如果 destination 是目錄，則會出現(xiàn)錯(cuò)誤。

如果 source 使用通配符，但并沒有相匹配的文件時(shí)，則會出現(xiàn)錯(cuò)誤。CopyFile 方法在遇到出現(xiàn)的第一個(gè)錯(cuò)誤時(shí)停止。該方法不會撤消錯(cuò)誤發(fā)生前所作的任何更改。