HOW TO：在 Visual Basic 中於不同資料夾內建立檔案複本

發行項
08/21/2008

更新：2007 年 11 月

My.Computer.FileSystem.CopyFile 方法允許您複製檔案。它的參數會提供覆寫現有檔案、重新命名檔案、顯示作業進度等功能，並且允許使用者取消作業。

若要將文字檔複製到其他資料夾

使用 CopyFile 方法複製檔案，並且指定來源檔案和目標目錄。 overwrite 參數允許您指定是否覆寫現有的檔案。下列程式碼範例會使用 CopyFile。

' Copy the file to a new location without overwriting existing file.
My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\testFile.txt", _
    "C:\UserFiles\TestFiles2\testFile.txt")

' Copy the file to a new folder, overwriting existing file.
My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\testFile.txt", _
    "C:\UserFiles\TestFiles2\testFile.txt", _
    FileIO.UIOption.AllDialogs, _
    FileIO.UICancelOption.DoNothing)

' Copy the file to a new folder and rename it.
My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\testFile.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.AllDialogs, _
    FileIO.UICancelOption.DoNothing)

穩固程式設計

下列條件可能造成擲回例外狀況：

因下列其中一項原因而導致路徑無效：它是長度為零的字串、它只包含空白字元、它包含無效的字元，或者它是裝置路徑 (開頭為 \\.\) (ArgumentException)。
系統無法擷取絕對路徑 (ArgumentException)。
路徑無效，因為它是 Nothing (ArgumentNullException)。
原始程式檔無效或不存在 (FileNotFoundException)。
組合路徑會指向現有的目錄 (IOException)。
目的檔存在且 overwrite 設定為 False (IOException)。
使用者沒有足夠的使用權限可以存取檔案 (IOException)。
目標資料夾中具有相同名稱的檔案正在使用中 (IOException)。
路徑中的檔案或資料夾名稱含有冒號 (:)，或者是無效的格式 (NotSupportedException)。
ShowUI 設為 True、onUserCancel 設為 ThrowException，而且使用者已取消作業 (OperationCanceledException)。
ShowUI 設為 True、onUserCancel 設為 ThrowException，而且發生未指定的 I/O 錯誤 (OperationCanceledException)。
路徑超過系統定義的最大長度 (PathTooLongException)。
使用者未具備必要的使用權限 (UnauthorizedAccessException)。
使用者缺乏必要的使用權限來檢視路徑 (SecurityException)。