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 方法在遇到出現的第一個錯誤時停止。該方法不會撤消錯誤發生前所作的任何更改。