共用方式為


CopyFile 方法

將一或多個檔案從一個位置複製到另一個位置。

語法

物件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 支援與意見反應