CopyFolder 方法
以遞歸方式將資料夾從一個位置複製到另一個位置。
語法
物件。CopyFoldersource, destination, [ overwrite ]
CopyFolder 方法語法具有下列部分:
部分 | 描述 |
---|---|
物件 | 必要。 名稱一律為 FileSystemObject。 |
source | 此為必要動作。 字元字串資料夾規格,可以包含通配符,以便複製一或多個資料夾。 |
destination | 此為必要動作。 要從 來源 複製資料夾和子資料夾的字元字串目的地。 不允許使用通配符。 |
改寫 | 選用。 布爾 值,指出是否要覆寫現有的資料夾。 如果 為 True,則會覆寫檔案;如果 為 False,則不是。 預設值為 True 。 |
註解
通配符只能在 來源 自變數的最後一個路徑元件中使用。 例如,您可以使用:
FileSystemObject.CopyFolder "c:\mydocuments\letters\*", "c:\tempfolder\"
但您無法使用:
FileSystemObject.CopyFolder "c:\mydocuments\*\*", "c:\tempfolder\"
如果 source 包含通配符,或 目的地 結尾為路徑分隔符 (\
) ,則會假設 destination 是複製相符資料夾和子資料夾的現有資料夾。 否則, 目的地 會假設為要建立的資料夾名稱。 不論是哪一種情況,複製個別資料夾時都可能發生四件事:
如果 destination 不存在,則會複製 源 數據夾及其所有內容。 這是通常的情況。
如果 destination 是現有的檔案,則會發生錯誤。
如果 destination 是目錄,則會嘗試複製資料夾及其所有內容。 如果 來源中包含 的檔案已經存在於 目的地中,如果 覆寫 為 False,就會發生錯誤。 否則,它會嘗試將檔案複製到現有的檔案上。
如果 destination 是唯讀目錄,則如果嘗試將現有的唯讀檔案複製到該目錄並 覆寫 為 False,就會發生錯誤。
如果使用通配符的 來源 不符合任何資料夾,也會發生錯誤。
CopyFolder 方法會在遇到第一個錯誤時停止。 不會嘗試復原在發生錯誤之前所做的任何變更。
另請參閱
支援和意見反應
有關於 Office VBA 或這份文件的問題或意見反應嗎? 如需取得支援服務並提供意見反應的相關指導,請參閱 Office VBA 支援與意見反應。