FileSystemProxy.CopyFile 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將檔案複製到新位置。
多載
| 名稱 | Description |
|---|---|
| CopyFile(String, String) |
將檔案複製到新位置。 |
| CopyFile(String, String, UIOption) |
將檔案複製到新位置。 |
| CopyFile(String, String, Boolean) |
將檔案複製到新位置。 |
| CopyFile(String, String, UIOption, UICancelOption) |
將檔案複製到新位置。 |
CopyFile(String, String)
將檔案複製到新位置。
public:
void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName);public void CopyFile(string sourceFileName, string destinationFileName);member this.CopyFile : string * string -> unitPublic Sub CopyFile (sourceFileName As String, destinationFileName As String)參數
- sourceFileName
- String
要複製的檔案。
- destinationFileName
- String
檔案應該複製到的位置。
例外狀況
destinationFileName 包含路徑資訊。
destinationFileName 或 sourceFileName 是 Nothing 空字串。
原始檔案無效或不存在。
目標目錄中同名的檔案正在使用中。
路徑中的檔案或目錄名稱包含冒號（:)，或格式無效。
路徑超過系統定義的最大長度。
使用者無需取得所需的權限。
使用者缺乏必要的權限來查看路徑。
範例
此範例將檔案 Test.txt 複製至目錄 TestFiles2 ，且不覆寫現有檔案。
My.Computer.FileSystem.CopyFile( _
"C:\UserFiles\TestFiles\test.txt", _
"C:\UserFiles\TestFiles2\test.txt", overwrite:=False)
把檔案路徑替換成你想在程式碼中使用的路徑。
此範例將檔案 Test.txt 複製到目錄 TestFiles2 並重新命名 NewFile.txt。
My.Computer.FileSystem.CopyFile( _
"C:\UserFiles\TestFiles\test.txt", _
"C:\UserFiles\TestFiles2\NewFile.txt", _
FileIO.UIOption.OnlyErrorDialogs, _
FileIO.UICancelOption.DoNothing)
把檔案路徑替換成你想在程式碼中使用的路徑。
備註
CopyFile 不保留 ACE（存取控制 條目）。 新建立的檔案會繼承其所建立目錄的預設 ACE。
下表列出與此 My.Computer.FileSystem.CopyFile 方法相關的任務範例。
| 至 | 看！ |
|---|---|
| 把檔案複製到同一個目錄。 | 如何：在同一目錄中建立檔案的複製 |
| 把檔案複製到另一個目錄。 | 如何：在不同目錄中建立檔案的複製 |
另請參閱
- UICancelOption
- 物件（Visual Basic ）
如何：將特定模式的檔案複製到Visual Basic 如何：在 Visual Basic - 如何：將目錄複製到另一個目錄Visual Basic
- 如何：在 Visual Basic 中重新命名檔案
適用於
CopyFile(String, String, UIOption)
將檔案複製到新位置。
public:
void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);public void CopyFile(string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);member this.CopyFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unitPublic Sub CopyFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)參數
- sourceFileName
- String
要複製的檔案。
- destinationFileName
- String
檔案應該複製到的位置。
- showUI
- UIOption
是否要目視追蹤行動進度。 預設值為 UIOption.OnlyErrorDialogs。
例外狀況
destinationFileName 包含路徑資訊。
destinationFileName 或 sourceFileName 是 Nothing 空字串。
原始檔案無效或不存在。
目標檔案存在且 overwrite 設定為 False。
路徑中的檔案或目錄名稱包含冒號（:)，或格式無效。
路徑超過系統定義的最大長度。
使用者無需取得所需的權限。
使用者缺乏必要的權限來查看路徑。
範例
此範例將檔案 Test.txt 複製至目錄 TestFiles2 ，且不覆寫現有檔案。
My.Computer.FileSystem.CopyFile( _
"C:\UserFiles\TestFiles\test.txt", _
"C:\UserFiles\TestFiles2\test.txt", overwrite:=False)
把檔案路徑替換成你想在程式碼中使用的路徑。
此範例將檔案 Test.txt 複製到目錄 TestFiles2 並重新命名 NewFile.txt。
My.Computer.FileSystem.CopyFile( _
"C:\UserFiles\TestFiles\test.txt", _
"C:\UserFiles\TestFiles2\NewFile.txt", _
FileIO.UIOption.OnlyErrorDialogs, _
FileIO.UICancelOption.DoNothing)
把檔案路徑替換成你想在程式碼中使用的路徑。
備註
CopyFile 不保留 ACE（存取控制 條目）。 新建立的檔案會繼承其所建立目錄的預設 ACE。
下表列出與此 My.Computer.FileSystem.CopyFile 方法相關的任務範例。
| 至 | 看！ |
|---|---|
| 把檔案複製到同一個目錄。 | 如何：在同一目錄中建立檔案的複製 |
| 把檔案複製到另一個目錄。 | 如何：在不同目錄中建立檔案的複製 |
另請參閱
- UICancelOption
- 物件（Visual Basic ）
如何：將特定模式的檔案複製到Visual Basic 如何：在 Visual Basic - 如何：將目錄複製到另一個目錄Visual Basic
- 如何：在 Visual Basic 中重新命名檔案
適用於
CopyFile(String, String, Boolean)
將檔案複製到新位置。
public:
void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);public void CopyFile(string sourceFileName, string destinationFileName, bool overwrite);member this.CopyFile : string * string * bool -> unitPublic Sub CopyFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)參數
- sourceFileName
- String
要複製的檔案。
- destinationFileName
- String
檔案應該複製到的位置。
- overwrite
- Boolean
True 是否應該覆寫現有檔案;否則 False。 預設值為 False。
例外狀況
destinationFileName 包含路徑資訊。
destinationFileName 或 sourceFileName 是 Nothing 空字串。
原始檔案無效或不存在。
目標檔案存在且 overwrite 設定為 False。
路徑中的檔案或目錄名稱包含冒號（:)，或格式無效。
路徑超過系統定義的最大長度。
使用者無需取得所需的權限。
使用者缺乏必要的權限來查看路徑。
範例
此範例將檔案 Test.txt 複製至目錄 TestFiles2 ，且不覆寫現有檔案。
My.Computer.FileSystem.CopyFile( _
"C:\UserFiles\TestFiles\test.txt", _
"C:\UserFiles\TestFiles2\test.txt", overwrite:=False)
把檔案路徑替換成你想在程式碼中使用的路徑。
此範例將檔案 Test.txt 複製到目錄 TestFiles2 並重新命名 NewFile.txt。
My.Computer.FileSystem.CopyFile( _
"C:\UserFiles\TestFiles\test.txt", _
"C:\UserFiles\TestFiles2\NewFile.txt", _
FileIO.UIOption.OnlyErrorDialogs, _
FileIO.UICancelOption.DoNothing)
把檔案路徑替換成你想在程式碼中使用的路徑。
備註
CopyFile 不保留 ACE（存取控制 條目）。 新建立的檔案會繼承其所建立目錄的預設 ACE。
下表列出與此 My.Computer.FileSystem.CopyFile 方法相關的任務範例。
| 至 | 看！ |
|---|---|
| 把檔案複製到同一個目錄。 | 如何：在同一目錄中建立檔案的複製 |
| 把檔案複製到另一個目錄。 | 如何：在不同目錄中建立檔案的複製 |
另請參閱
- UICancelOption
- 物件（Visual Basic ）
如何：將特定模式的檔案複製到Visual Basic 如何：在 Visual Basic - 如何：將目錄複製到另一個目錄Visual Basic
- 如何：在 Visual Basic 中重新命名檔案
適用於
CopyFile(String, String, UIOption, UICancelOption)
將檔案複製到新位置。
public:
void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);public void CopyFile(string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);member this.CopyFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unitPublic Sub CopyFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)參數
- sourceFileName
- String
要複製的檔案。
- destinationFileName
- String
檔案應該複製到的位置。
- showUI
- UIOption
是否要目視追蹤行動進度。 預設值為 UIOption.OnlyErrorDialogs。
- onUserCancel
- UICancelOption
說明若使用者在操作過程中點擊 取消 ，應採取的步驟。 預設值為 ThrowException。
例外狀況
destinationFileName 包含路徑資訊。
destinationFileName 或 sourceFileName 是 Nothing 空字串。
原始檔案無效或不存在。
目標檔案存在且 overwrite 設定為 False。
路徑中的檔案或目錄名稱包含冒號（:)，或格式無效。
路徑超過系統定義的最大長度。
使用者無需取得所需的權限。
使用者缺乏必要的權限來查看路徑。
UICancelOption 設定為 ThrowException，且使用者已取消操作或發生未說明的 I/O 錯誤。
範例
此範例將檔案 Test.txt 複製至目錄 TestFiles2 ，且不覆寫現有檔案。
My.Computer.FileSystem.CopyFile( _
"C:\UserFiles\TestFiles\test.txt", _
"C:\UserFiles\TestFiles2\test.txt", overwrite:=False)
把檔案路徑替換成你想在程式碼中使用的路徑。
此範例將檔案 Test.txt 複製到目錄 TestFiles2 並重新命名 NewFile.txt。
My.Computer.FileSystem.CopyFile( _
"C:\UserFiles\TestFiles\test.txt", _
"C:\UserFiles\TestFiles2\NewFile.txt", _
FileIO.UIOption.OnlyErrorDialogs, _
FileIO.UICancelOption.DoNothing)
把檔案路徑替換成你想在程式碼中使用的路徑。
備註
CopyFile 不保留 ACE（存取控制 條目）。 新建立的檔案會繼承其所建立目錄的預設 ACE。
下表列出與此 My.Computer.FileSystem.CopyFile 方法相關的任務範例。
| 至 | 看！ |
|---|---|
| 把檔案複製到同一個目錄。 | 如何：在同一目錄中建立檔案的複製 |
| 把檔案複製到另一個目錄。 | 如何：在不同目錄中建立檔案的複製 |
另請參閱
- UICancelOption
- 物件（Visual Basic ）
如何：將特定模式的檔案複製到Visual Basic 如何：在 Visual Basic - 如何：將目錄複製到另一個目錄Visual Basic
- 如何：在 Visual Basic 中重新命名檔案