共用方式為


FileSystemProxy.CopyFile 方法

定義

將檔案複製至新的位置。

多載

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

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

例外狀況

destinationFileName 包含路徑資訊。

destinationFileNamesourceFileNameNothing 或空字串。

來源檔案無效或不存在。

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

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

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

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

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

範例

本範例會將檔案 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

例外狀況

destinationFileName 包含路徑資訊。

destinationFileNamesourceFileNameNothing 或空字串。

來源檔案無效或不存在。

目的檔存在且 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 方法的工作範例。

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

另請參閱

適用於

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

例外狀況

destinationFileName 包含路徑資訊。

destinationFileNamesourceFileNameNothing 或空字串。

來源檔案無效或不存在。

目的檔存在且 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 方法的工作範例。

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

另請參閱

適用於

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

例外狀況

destinationFileName 包含路徑資訊。

destinationFileNamesourceFileNameNothing 或空字串。

來源檔案無效或不存在。

目的檔存在且 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 範例。

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

另請參閱

適用於