My.Computer.FileSystem.CopyFile 方法

發行項
08/21/2008

更新：2007 年 11 月

將檔案複製到新位置。

 ' Usage My.Computer.FileSystem.CopyFile(sourceFileName ,destinationFileName) My.Computer.FileSystem.CopyFile(sourceFileName ,destinationFileName ,overwrite) My.Computer.FileSystem.CopyFile(sourceFileName ,destinationFileName ,showUI) My.Computer.FileSystem.CopyFile(sourceFileName ,destinationFileName ,showUI ,onUserCancel) ' Declaration Public Sub CopyFile( _    ByVal sourceFileName As String, _    ByVal destinationFileName As String _ ) ' -or- Public Sub CopyFile( _    ByVal sourceFileName As String, _    ByVal destinationFileName As String, _    ByVal overwrite As Boolean _ ) ' -or- Public Sub CopyFile( _    ByVal sourceFileName As String, _    ByVal destinationFileName As String, _    ByVal showUI As UIOption _ ) ' -or- Public Sub CopyFile( _    ByVal sourceFileName As String, _    ByVal destinationFileName As String, _    ByVal showUI As UIOption, _    ByVal onUserCancel As UICancelOption _ )

參數

sourceFileName
String：要複製的檔案。必要項。
destinationFileName
String：應複製檔案的目標位置。必要項。
overwrite
Boolean：是否應覆寫現有的檔案。預設值為 False。必要項。
showUI
UIOption。是否要視覺化追蹤作業的進度。預設值為 UIOption.OnlyErrorDialogs。必要項。
onUserCancel
UICancelOption。指定使用者在作業期間按一下 [取消] 時，所應執行的工作。預設值為 ThrowException。必要項。

例外狀況

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

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

備註

CopyFile 未保留 ACE (存取控制項目)。最新建立的檔案會繼承在其中建立它之目錄的預設 ACE。

工作

下表列出包含 My.Computer.FileSystem.CopyFile 方法的工作範例。

若要	請參閱
將檔案複製到相同目錄。	HOW TO：在 Visual Basic 中於相同目錄內建立檔案複本
將檔案複製到不同目錄。	HOW TO：在 Visual Basic 中於不同資料夾內建立檔案複本

範例

這個範例會將檔案 Test.txt 複製到目錄 TestFiles2 ，而不覆寫現有檔案。

My.Computer.FileSystem.CopyFile _
("C:\UserFiles\TestFiles\test.txt", _
"C:\UserFiles\TestFiles2")

將檔案路徑取代為想要在程式碼中使用的路徑。

這個範例會將檔案 Test.txt 複製到目錄 TestFiles2，並將它重新命名為 NewFile.txt。

My.Computer.FileSystem.CopyFile _
("C:\UserFiles\TestFiles\test.txt", _
"C:\UserFiles\TestFiles2", "NewFile.txt", FileIO.UICancelOption.DoNothing)

將檔案路徑取代為想要在程式碼中使用的路徑。

需求

命名空間 (Namespace)︰Microsoft.VisualBasic.MyServices

類別 (Class)：FileSystemProxy (提供對 FileSystem 的存取)

組件：Visual Basic 執行階段程式庫 (在 Microsoft.VisualBasic.dll 中)

依專案類型的可用性

專案類型	是否可用
Windows 應用程式	是
類別庫	是
主控台應用程式	是
Windows 控制項程式庫	是
Web 控制項程式庫	是
Windows 服務	是
網站	是

使用權限

下列使用權限可能為必要：

使用權限	描述
EnvironmentPermission	控制存取所有環境變數的能力。關聯的列舉型別：Unrestricted。
FileIOPermission	控制存取檔案和資料夾的功能。關聯的列舉型別：Unrestricted。
RegistryPermission	控制存取登錄變數的能力。關聯的列舉型別：Unrestricted。
UIPermission	控制與使用者介面和剪貼簿相關的使用權限。關聯的列舉型別：SafeSubWindows。