FileSystem.CopyFile 方法

定義

命名空間:

Microsoft.VisualBasic.FileIO

組件:

Microsoft.VisualBasic.Core.dll

將檔案複製至新的位置。

多載

CopyFile(String, String)	將檔案複製至新的位置。
CopyFile(String, String, UIOption)	將檔案複製至新的位置。
CopyFile(String, String, Boolean)	將檔案複製至新的位置。
CopyFile(String, String, UIOption, UICancelOption)	將檔案複製至新的位置。

CopyFile(String, String)

來源:

FileSystem.vb

將檔案複製至新的位置。

public:
 static void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName);

public static void CopyFile (string sourceFileName, string destinationFileName);

static member CopyFile : string * string -> unit

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

收件者	請參閱
將檔案複製到相同的目錄。	如何：在 Visual Basic 中於相同目錄內建立檔案複本
將檔案複製到不同的目錄。	如何：在 Visual Basic 中於不同資料夾內建立檔案複本

另請參閱

• UICancelOption

CopyFile(String, String, UIOption)

來源:

FileSystem.vb

將檔案複製至新的位置。

public:
 static void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);

public static void CopyFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);

static member CopyFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit

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

收件者	請參閱
將檔案複製到相同的目錄。	如何：在 Visual Basic 中於相同目錄內建立檔案複本
將檔案複製到不同的目錄。	如何：在 Visual Basic 中於不同資料夾內建立檔案複本

另請參閱

• UICancelOption

CopyFile(String, String, Boolean)

來源:

FileSystem.vb

將檔案複製至新的位置。

public:
 static void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);

public static void CopyFile (string sourceFileName, string destinationFileName, bool overwrite);

static member CopyFile : string * string * bool -> unit

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

收件者	請參閱
將檔案複製到相同的目錄。	如何：在 Visual Basic 中於相同目錄內建立檔案複本
將檔案複製到不同的目錄。	如何：在 Visual Basic 中於不同資料夾內建立檔案複本

另請參閱

• UICancelOption

CopyFile(String, String, UIOption, UICancelOption)

來源:

FileSystem.vb

將檔案複製至新的位置。

public:
 static void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public static void CopyFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

static member CopyFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Shared 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 方法的工作範例。

收件者	請參閱
將檔案複製到相同的目錄。	如何：在 Visual Basic 中於相同目錄內建立檔案複本
將檔案複製到不同的目錄。	如何：在 Visual Basic 中於不同資料夾內建立檔案複本

另請參閱

• UICancelOption