FileSystemProxy.CopyFile 方法

參考

定義

命名空間:: Microsoft.VisualBasic.MyServices

組件:: Microsoft.VisualBasic.dll

組件:: Microsoft.VisualBasic.Forms.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將檔案複製至新的位置。

多載

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 -> unit

Public Sub CopyFile (sourceFileName As String, destinationFileName As String)

參數

sourceFileName: String

要複製的檔案。

destinationFileName: String

要在其中貼上複製檔案的位置

例外狀況

ArgumentException

destinationFileName 包含路徑資訊。

ArgumentNullException

destinationFileName 或 sourceFileName 為 Nothing 或空字串。

FileNotFoundException

來源檔案無效或不存在。

IOException

目標目錄中具有相同名稱的檔案正在使用中。

NotSupportedException

路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式。

PathTooLongException

路徑超過系統定義的最大長度。

UnauthorizedAccessException

使用者未具備必要的使用權限。

SecurityException

使用者缺乏必要的使用權限來檢視路徑。

範例

本範例會將檔案 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 方法的工作範例。

收件者	請參閱
將檔案複製到相同的目錄。	作法：在相同目錄中建立檔案複本
將檔案複製到不同的目錄。	作法：在不同目錄中建立檔案複本

另請參閱

適用於

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 -> unit

Public Sub CopyFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)

參數

sourceFileName: String

要複製的檔案。

destinationFileName: String

要在其中貼上複製檔案的位置

showUI: UIOption

是否要以視覺方式追蹤作業進度。預設為 UIOption.OnlyErrorDialogs。

例外狀況

ArgumentException

destinationFileName 包含路徑資訊。

ArgumentNullException

destinationFileName 或 sourceFileName 為 Nothing 或空字串。

FileNotFoundException

來源檔案無效或不存在。

IOException

目的檔存在且 overwrite 設定為 False。

NotSupportedException

路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式。

PathTooLongException

路徑超過系統定義的最大長度。

UnauthorizedAccessException

使用者未具備必要的使用權限。

SecurityException

使用者缺乏必要的使用權限來檢視路徑。

範例

本範例會將檔案 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 方法的工作範例。

收件者	請參閱
將檔案複製到相同的目錄。	作法：在相同目錄中建立檔案複本
將檔案複製到不同的目錄。	作法：在不同目錄中建立檔案複本

另請參閱

適用於

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 -> unit

Public Sub CopyFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)

參數

sourceFileName: String

要複製的檔案。

destinationFileName: String

要在其中貼上複製檔案的位置

overwrite: Boolean

如果應該覆寫現有的檔案則為 True，否則為 False。預設為 False。

例外狀況

ArgumentException

destinationFileName 包含路徑資訊。

ArgumentNullException

destinationFileName 或 sourceFileName 為 Nothing 或空字串。

FileNotFoundException

來源檔案無效或不存在。

IOException

目的檔存在且 overwrite 設定為 False。

NotSupportedException

路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式。

PathTooLongException

路徑超過系統定義的最大長度。

UnauthorizedAccessException

使用者未具備必要的使用權限。

SecurityException

使用者缺乏必要的使用權限來檢視路徑。

範例

本範例會將檔案 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 方法的工作範例。

收件者	請參閱
將檔案複製到相同的目錄。	作法：在相同目錄中建立檔案複本
將檔案複製到不同的目錄。	作法：在不同目錄中建立檔案複本

另請參閱

適用於

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 -> unit

Public 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。

例外狀況

ArgumentException

destinationFileName 包含路徑資訊。

ArgumentNullException

destinationFileName 或 sourceFileName 為 Nothing 或空字串。

FileNotFoundException

來源檔案無效或不存在。

IOException

目的檔存在且 overwrite 設定為 False。

NotSupportedException

路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式。

PathTooLongException

路徑超過系統定義的最大長度。

UnauthorizedAccessException

使用者未具備必要的使用權限。

SecurityException

使用者缺乏必要的使用權限來檢視路徑。

OperationCanceledException

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 範例。

收件者	請參閱
將檔案複製到相同的目錄。	作法：在相同目錄中建立檔案複本
將檔案複製到不同的目錄。	作法：在不同目錄中建立檔案複本

另請參閱

適用於

共用方式為

FileSystemProxy.CopyFile 方法

定義

多載

CopyFile(String, String)

參數

例外狀況

範例

備註

另請參閱

適用於

CopyFile(String, String, UIOption)

參數

例外狀況

範例

備註

另請參閱

適用於

CopyFile(String, String, Boolean)

參數

例外狀況

範例

備註

另請參閱

適用於

CopyFile(String, String, UIOption, UICancelOption)

參數

例外狀況

範例

備註

另請參閱

適用於

其他資源