FileSystem.CopyDirectory 方法

定義

命名空間:

Microsoft.VisualBasic.FileIO

組件:

Microsoft.VisualBasic.Core.dll

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

多載

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

CopyDirectory(String, String)

來源:

FileSystem.vb

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

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")

將和 C:\TestDirectory2 取代C:\TestDirectory1為您想要複製之目錄的路徑和名稱，以及您想要複製它的位置。

備註

這個方法會將來源目錄的內容複製到目標目錄。 如果目標目錄不存在，則會建立它。 如果目標位置中有同名的目錄，則會合併兩個目錄的內容。 您可以在作業期間指定目錄的新名稱。

複製目錄中的檔案時，可能會擲回特定檔案所造成的例外狀況。 擲回這類例外狀況時，這些例外狀況會合併成單一例外狀況，其 Data 屬性會以索引鍵或目錄路徑的形式 IDictionary 保存專案，而特定例外狀況訊息會包含在對應的值中。 使用 For…Each 來列舉專案。

下表列出涉及 My.Computer.FileSystem.CopyDirectory 方法的工作範例。

收件者	請參閱
複製目錄	如何：在 Visual Basic 中將目錄複製到另一個目錄

另請參閱

• UICancelOption

CopyDirectory(String, String, UIOption)

來源:

FileSystem.vb

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

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，且使用者會取消作業，或是無法複製目錄中的一個或多個檔案。

範例

下列範例會將目錄TestDirectory1TestDirectory2的內容複製到 ，其中顯示進度對話框和任何錯誤對話方塊。

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

將和 C:\TestDirectory2 取代C:\TestDirectory1為您想要複製之目錄的路徑和名稱，以及您想要複製它的位置。

備註

這個方法會將來源目錄的內容複製到目標目錄。 如果目標目錄不存在，則會建立它。 如果目標位置中有同名的目錄，則會合併兩個目錄的內容。 您可以在作業期間指定目錄的新名稱。

複製目錄中的檔案時，可能會擲回特定檔案所造成的例外狀況。 擲回這類例外狀況時，這些例外狀況會合併成單一例外狀況，其 Data 屬性會以索引鍵或目錄路徑的形式 IDictionary 保存專案，而特定例外狀況訊息會包含在對應的值中。 使用 For…Each 來列舉專案。

下表列出涉及 My.Computer.FileSystem.CopyDirectory 方法的工作範例。

收件者	請參閱
複製目錄	如何：在 Visual Basic 中將目錄複製到另一個目錄

另請參閱

• UICancelOption

CopyDirectory(String, String, Boolean)

來源:

FileSystem.vb

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

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

目的檔案存在，但無法存取它。

範例

下列範例會將目錄TestDirectory1TestDirectory2的內容複製到 ，並覆寫現有的檔案。

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

將和 C:\TestDirectory2 取代C:\TestDirectory1為您想要複製之目錄的路徑和名稱，以及您想要複製它的位置。

備註

這個方法會將來源目錄的內容複製到目標目錄。 如果目標目錄不存在，則會建立它。 如果目標位置中有同名的目錄，則會合併兩個目錄的內容。 您可以在作業期間指定目錄的新名稱。

複製目錄中的檔案時，可能會擲回特定檔案所造成的例外狀況，例如合併 overwrite 期間現有的檔案設定為 False。 擲回這類例外狀況時，這些例外狀況會合併成單一例外狀況，其 Data 屬性會以索引鍵或目錄路徑的形式 IDictionary 保存專案，而特定例外狀況訊息會包含在對應的值中。 使用 For…Each 來列舉專案。

下表列出涉及 My.Computer.FileSystem.CopyDirectory 方法的工作範例。

收件者	請參閱
複製目錄	如何：在 Visual Basic 中將目錄複製到另一個目錄

另請參閱

• UICancelOption

CopyDirectory(String, String, UIOption, UICancelOption)

來源:

FileSystem.vb

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

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，且使用者會取消作業，或是無法複製目錄中的一個或多個檔案。

範例

下列範例會將目錄TestDirectory1TestDirectory2的內容複製到 ，其中顯示進度對話框和任何錯誤對話方塊，如果使用者在作業期間按兩下 [取消]，則不會執行任何動作。

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

將和 C:\TestDirectory2 取代C:\TestDirectory1為您想要複製之目錄的路徑和名稱，以及您想要複製它的位置。

備註

這個方法會將來源目錄的內容複製到目標目錄。 如果目標目錄不存在，則會建立它。 如果具有相同名稱的目錄存在於目標位置，則會合併兩個目錄的內容。 您可以在作業期間指定目錄的新名稱。

複製目錄中的檔案時，可能會擲回特定檔案所造成的例外狀況。 擲回這類例外狀況時，這些例外狀況會合併成單一例外狀況，其 Data 屬性會保存檔案或目錄路徑為索引鍵的 IDictionary ，而特定例外狀況訊息會包含在對應的值中。 使用 For…Each 列舉專案。

下表列出涉及 My.Computer.FileSystem.CopyDirectory 方法的工作範例。

收件者	請參閱
複製目錄	如何：在 Visual Basic 中將目錄複製到另一個目錄

另請參閱

• UICancelOption