FileSystem.CopyDirectory 方法

定義

命名空間:

Microsoft.VisualBasic.FileIO

組件:

Microsoft.VisualBasic.dll

將一個目錄的內容複製到另一個目錄。

多載

名稱	Description
CopyDirectory(String, String)	將一個目錄的內容複製到另一個目錄。
CopyDirectory(String, String, UIOption)	將一個目錄的內容複製到另一個目錄。
CopyDirectory(String, String, Boolean)	將一個目錄的內容複製到另一個目錄。
CopyDirectory(String, String, UIOption, UICancelOption)	將一個目錄的內容複製到另一個目錄。

CopyDirectory(String, String)

將一個目錄的內容複製到另一個目錄。

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName);

public static void CopyDirectory(string sourceDirectoryName, string destinationDirectoryName);

static member CopyDirectory : string * string -> unit

Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String)

參數

sourceDirectoryName

String

要複製的目錄。

destinationDirectoryName

String

目錄內容應該複製到的位置。

例外狀況

ArgumentException

該路徑不成立，原因之一是：它是零長度字串;它僅包含空白;它包含無效字元;或者是裝置路徑（以 \\.\ 開頭）。

ArgumentNullException

destinationDirectoryName 或 sourceDirectoryName 是 Nothing 空字串。

DirectoryNotFoundException

來源目錄不存在。

IOException

來源路徑和目標路徑是相同的。

InvalidOperationException

這個運算是循環的。

PathTooLongException

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

NotSupportedException

路徑中的資料夾名稱包含冒號（:)或格式無效。

SecurityException

使用者缺乏必要的權限來查看路徑。

UnauthorizedAccessException

目標檔案存在但無法存取。

範例

以下範例將目錄 TestDirectory1 的內容複製到 TestDirectory2。

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2")

將 and C:\TestDirectory2 替換C:\TestDirectory1成你想複製目錄的路徑和名稱，以及你想複製的位置。

備註

此方法將來源目錄的內容複製到目標目錄。 如果目標目錄不存在，則會建立它。 如果目標位置存在同名目錄，則兩個目錄的內容會合併。 你可以在操作過程中為目錄指定新名稱。

在目錄內複製檔案時，可能會拋出由特定檔案引起的例外。 當拋出此類例外時，會合併成單一例外，該 Data 異常性質包含 IDictionary 以檔案或目錄路徑為鍵，特定異常訊息包含於相應值中。 用來 For…Each 列舉條目。

下表列出一個涉及此 My.Computer.FileSystem.CopyDirectory 方法的任務範例。

至	看！
複製目錄	如何：將目錄複製到另一個目錄Visual Basic

另請參閱

• UICancelOption

CopyDirectory(String, String, UIOption)

將一個目錄的內容複製到另一個目錄。

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI);

public static void CopyDirectory(string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI);

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

Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption)

參數

sourceDirectoryName

String

要複製的目錄。

destinationDirectoryName

String

目錄內容應該複製到的位置。

showUI

UIOption

是否要目視追蹤行動進度。 預設值為 UIOption.OnlyErrorDialogs。

例外狀況

ArgumentException

該路徑不成立，原因之一是：它是零長度字串;它僅包含空白;它包含無效字元;或者是裝置路徑（以 \\.\ 開頭）。

ArgumentNullException

destinationDirectoryName 或 sourceDirectoryName 是 Nothing 空字串。

DirectoryNotFoundException

來源目錄不存在。

IOException

來源路徑和目標路徑是相同的。

InvalidOperationException

這個運算是循環的。

PathTooLongException

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

NotSupportedException

路徑中的資料夾名稱包含冒號（:)或格式無效。

SecurityException

使用者缺乏必要的權限來查看路徑。

UnauthorizedAccessException

目標檔案存在但無法存取。

OperationCanceledException

ShowUI 設定為 ， UIOption.AllDialogs 使用者取消操作，或目錄中的一個或多個檔案無法複製。

範例

以下範例將目錄 TestDirectory1 內容複製到 TestDirectory2，顯示進度對話框及任何錯誤對話框。

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", UIOption.AllDialogs)

將 and C:\TestDirectory2 替換C:\TestDirectory1成你想複製目錄的路徑和名稱，以及你想複製的位置。

備註

此方法將來源目錄的內容複製到目標目錄。 如果目標目錄不存在，則會建立它。 如果目標位置存在同名目錄，則兩個目錄的內容會合併。 你可以在操作過程中為目錄指定新名稱。

在目錄內複製檔案時，可能會拋出由特定檔案引起的例外。 當拋出此類例外時，會合併成單一例外，該 Data 異常性質包含 IDictionary 以檔案或目錄路徑為鍵，特定異常訊息包含於相應值中。 用來 For…Each 列舉條目。

下表列出一個涉及此 My.Computer.FileSystem.CopyDirectory 方法的任務範例。

至	看！
複製目錄	如何：將目錄複製到另一個目錄Visual Basic

另請參閱

• UICancelOption

CopyDirectory(String, String, Boolean)

將一個目錄的內容複製到另一個目錄。

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, bool overwrite);

public static void CopyDirectory(string sourceDirectoryName, string destinationDirectoryName, bool overwrite);

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

Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, overwrite As Boolean)

參數

sourceDirectoryName

String

要複製的目錄。

destinationDirectoryName

String

目錄內容應該複製到的位置。

overwrite

Boolean

True 覆寫現有檔案;否則 False。 預設值為 False。

例外狀況

ArgumentException

該路徑不成立，原因之一是：它是零長度字串;它僅包含空白;它包含無效字元;或者是裝置路徑（以 \\.\ 開頭）。

ArgumentNullException

destinationDirectoryName 或 sourceDirectoryName 是 Nothing 空字串。

DirectoryNotFoundException

來源目錄不存在。

IOException

來源路徑和目標路徑是相同的。

InvalidOperationException

這個運算是循環的。

PathTooLongException

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

NotSupportedException

路徑中的資料夾名稱包含冒號（:)或格式無效。

SecurityException

使用者缺乏必要的權限來查看路徑。

UnauthorizedAccessException

目標檔案存在但無法存取。

範例

以下範例將目錄 TestDirectory1 內容複製到 TestDirectory2，並覆寫現有檔案。

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)

將 and C:\TestDirectory2 替換C:\TestDirectory1成你想複製目錄的路徑和名稱，以及你想複製的位置。

備註

此方法將來源目錄的內容複製到目標目錄。 如果目標目錄不存在，則會建立它。 如果目標位置存在同名目錄，則兩個目錄的內容會合併。 你可以在操作過程中為目錄指定新名稱。

在目錄內複製檔案時，可能會拋出由特定檔案引起的例外，例如合併時檔案存在且 overwrite 設定為 False。 當拋出此類例外時，會合併成單一例外，該 Data 異常性質包含 IDictionary 以檔案或目錄路徑為鍵，特定異常訊息包含於相應值中。 用來 For…Each 列舉條目。

下表列出一個涉及此 My.Computer.FileSystem.CopyDirectory 方法的任務範例。

至	看！
複製目錄	如何：將目錄複製到另一個目錄Visual Basic

另請參閱

• UICancelOption

CopyDirectory(String, String, UIOption, UICancelOption)

將一個目錄的內容複製到另一個目錄。

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public static void CopyDirectory(string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

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

Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption, onUserCancel As UICancelOption)

參數

sourceDirectoryName

String

要複製的目錄。

destinationDirectoryName

String

目錄內容應該複製到的位置。

showUI

UIOption

是否要目視追蹤行動進度。 預設值為 UIOption.OnlyErrorDialogs。

onUserCancel

UICancelOption

說明若使用者在操作過程中點擊 取消 ，應採取的步驟。 預設值為 ThrowException。

例外狀況

ArgumentException

該路徑不成立，原因之一是：它是零長度字串;它僅包含空白;它包含無效字元;或者是裝置路徑（以 \\.\ 開頭）。

ArgumentNullException

destinationDirectoryName 或 sourceDirectoryName 是 Nothing 空字串。

DirectoryNotFoundException

來源目錄不存在。

IOException

來源路徑和目標路徑是相同的。

InvalidOperationException

這個運算是循環的。

PathTooLongException

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

NotSupportedException

路徑中的資料夾名稱包含冒號（:)或格式無效。

SecurityException

使用者缺乏必要的權限來查看路徑。

UnauthorizedAccessException

目標檔案存在但無法存取。

OperationCanceledException

ShowUI 設定為 ， UIOption.AllDialogs 使用者取消操作，或目錄中的一個或多個檔案無法複製。

範例

以下範例將目錄 TestDirectory1 內容複製到 TestDirectory2，顯示進度對話框及任何錯誤對話框，若使用者在操作過程中點擊 取消 則不執行任何操作。

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", UIOption.AllDialogs, UICancelOption.DoNothing)

將 and C:\TestDirectory2 替換C:\TestDirectory1成你想複製目錄的路徑和名稱，以及你想複製的位置。

備註

此方法將來源目錄的內容複製到目標目錄。 如果目標目錄不存在，則會建立它。 如果目標位置存在同名目錄，則兩個目錄的內容會合併。 你可以在操作過程中為目錄指定新名稱。

在目錄內複製檔案時，可能會拋出由特定檔案引起的例外。 當拋出此類例外時，會合併成單一例外，該 Data 異常性質包含 IDictionary 以檔案或目錄路徑為鍵，特定異常訊息包含於相應值中。 用來 For…Each 列舉條目。

下表列出一個涉及此 My.Computer.FileSystem.CopyDirectory 方法的任務範例。

至	看！
複製目錄	如何：將目錄複製到另一個目錄Visual Basic

另請參閱

• UICancelOption