FileSystem.CopyFile 方法

定義

命名空間:: Microsoft.VisualBasic.FileIO

組件:: Microsoft.VisualBasic.dll

重要

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

將檔案複製到新位置。

多載

名稱	Description
CopyFile(String, String)	將檔案複製到新位置。
CopyFile(String, String, UIOption)	將檔案複製到新位置。
CopyFile(String, String, Boolean)	將檔案複製到新位置。
CopyFile(String, String, UIOption, UICancelOption)	將檔案複製到新位置。

CopyFile(String, String)

將檔案複製到新位置。

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)

將檔案複製到新位置。

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)

將檔案複製到新位置。

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)

將檔案複製到新位置。

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

適用於

意見反應

此頁面對您有幫助嗎？