Share via

CopyFile 方法

  • 發行項

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

語法

物件。CopyFilesource， destination， [ overwrite ]

CopyFile方法語法具有下列部分：

部分 描述
物件 此為必要動作。 物件一律是FileSystemObject的名稱。
source 此為必要動作。 字元字串檔案規格，可以包含萬用字元，以便複製一或多個檔案。
destination 此為必要動作。 要從 來源 複製檔案的字元字串目的地。 不允許使用萬用字元。
覆蓋 選用。 布林 值，指出是否要覆寫現有的檔案。 如果 為 True，則會覆寫檔案;如果 為 False，則不是。 預設值為 True 。 請注意，如果destination已設定唯讀屬性，無論覆寫的值為何，CopyFile都會失敗。

註解

萬用字元只能在 來源 引數的最後一個路徑元件中使用。 例如，您可以使用：

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

但您無法使用：

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

如果 source 包含萬用字元，或 目的地 結尾為路徑分隔符號 (*_) ，則會假設 destination 是複製相符檔案的現有資料夾。 否則， 目的地 會假設為要建立的檔案名。 不論是哪一種情況，複製個別檔案時都可能發生三件事：

  • 如果 destination 不存在，則 會複製來源 。 這是通常的情況。

  • 如果 destination 是現有的檔案，則覆 寫 為 False時會發生錯誤。 否則，會嘗試將 來源 複製到現有的檔案。

  • 如果 destination 是目錄，則會發生錯誤。

如果使用萬用字元的 來源 不符合任何檔案，也會發生錯誤。 CopyFile方法會在遇到第一個錯誤時停止。 不會嘗試復原或復原在發生錯誤之前所做的任何變更。

複製到新目的地路徑的檔案會保留相同的檔案名。 若要重新命名複製的檔案，只要在目的地路徑中包含新的檔案名即可。 例如，這會將檔案複製到新的位置， 而 新位置中的檔案會有不同的名稱：

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

另請參閱

支援和意見反應

有關於 Office VBA 或這份文件的問題或意見反應嗎？ 如需取得支援服務並提供意見反應的相關指導，請參閱 Office VBA 支援與意見反應。