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

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",
      Microsoft.VisualBasic.FileIO.UIOption.AllDialogs,
      Microsoft.VisualBasic.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",
      Microsoft.VisualBasic.FileIO.UIOption.AllDialogs,
      Microsoft.VisualBasic.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)。

另請參閱

• FileSystem
• CopyFile
• UICancelOption
• 如何：將具有特定模式的檔案複製到目錄
• 如何：在相同目錄內建立檔案複本
• 如何：將目錄複製到另一個目錄
• 如何：重新命名檔案