HOW TO：在 Visual Basic 中於相同目錄內建立檔案複本

發行項
08/21/2008

更新：2007 年 11 月

使用 My.Computer.FileSystem.CopyFile 方法複製檔案。此參數可讓您覆寫現有的檔案、重新命名檔案、顯示作業進度，並允許使用者取消作業。

若要在相同的資料夾中建立檔案的複本

請使用 CopyFile 方法，提供目標檔案和位置。下列範例會建立名為 test2.txt 之 test.txt 的複本。

My.Computer.FileSystem.CopyFile("C:\TestFolder\test.txt", _
"C:\TestFolder\test2.txt", Microsoft.VisualBasic.FileIO.UIOption.OnlyErrorDialogs, FileIO.UICancelOption.DoNothing)

若要在相同的資料夾中建立檔案的複本，以覆寫現有的檔案

請使用 CopyFile 方法，提供目標檔案和位置，並將 overwrite 設定為 True。下列範例會建立名為 test2.txt 之 test.txt 的複本，並以該名稱覆寫所有的現有檔案。
```
My.Computer.FileSystem.CopyFile("C:\TestFolder\test.txt", _
"C:\TestFolder\test2.txt", True)
```

穩固程式設計

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

因下列其中一項原因而導致路徑無效：它是長度為零的字串、它只包含空白字元、它包含無效的字元，或者它是裝置路徑 (開頭為 \\.\) (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)。