將一或多個檔案從一個位置複製到另一個位置。
語法
物件。CopyFile來源、 目的地、[ 覆寫 ]
CopyFile 方法語法包含以下部分:
| 部分 | 描述 |
|---|---|
| 物件 | 此為必要動作。 物件總是檔案系統物件的名稱。 |
| source | 此為必要動作。 字串檔案規範,可包含通配字元,用於複製一個或多個檔案。 |
| destination | 此為必要動作。 字串目的地,將檔案從 來源 複製到哪裡。 不允許使用萬用卡角色。 |
| 覆寫 | 選用。 布林值,指示是否要覆蓋現有檔案。 若 為真,檔案會被覆蓋;若 為 False,則不成立。 預設值為 True 。 請注意,如果目的地設定了唯讀屬性,無論覆寫值如何,CopyFile 都會失敗。 |
註解
萬用字元只能用於 來源 參數的最後一個路徑組件。 例如,你可以使用:
FileSystemObject.CopyFile "c:\mydocuments\letters\*.doc", "c:\tempfolder\"
但你不能使用:
FileSystemObject.CopyFile "c:\mydocuments\*\R1???97.xls", "c:\tempfolder"
如果 來源 包含通配字元,或 目的地 以路徑分隔符結尾 (****) ,則假設 目的地 是已存在的資料夾,用來複製相符檔案。 否則, 目的地 會被假設為要建立的檔案名稱。 無論哪種情況,當複製單一檔案時,可能發生三種情況:
如果目的地不存在,來源會被複製。 這是通常的情況。
如果 目的 是現有檔案,若覆 寫 為 False,則會發生錯誤。 否則,會嘗試將 原始碼 複製到現有檔案上。
如果 destination 是目錄,則會發生錯誤。
如果使用通配字 元的來源 與任何檔案不符,也會發生錯誤。 CopyFile 方法會在遇到第一個錯誤時停止。 在錯誤發生前,不會嘗試回滾或還原任何變更。
複製到新目的地路徑的檔案會保留相同的檔名。 若要重新命名複製的檔案,只需在目標路徑中加入新檔名即可。 例如,這會將檔案複製到新位置 ,且 新位置的檔案名稱會不同:
FileSystemObject.CopyFile "c:\mydocuments\letters\sample.doc", "c:\tempfolder\sample_new.doc"
另請參閱
支援和意見反應
有關於 Office VBA 或這份文件的問題或意見反應嗎? 如需取得支援服務並提供意見反應的相關指導,請參閱 Office VBA 支援與意見反應。