FileSystemProxy.CopyDirectory 方法

定義

命名空間:

Microsoft.VisualBasic.MyServices

組件:

Microsoft.VisualBasic.Forms.dll

將目錄複製至其他目錄。

多載

CopyDirectory(String, String)	將目錄複製至其他目錄。
CopyDirectory(String, String, UIOption)	將目錄複製至其他目錄。
CopyDirectory(String, String, Boolean)	將目錄複製至其他目錄。
CopyDirectory(String, String, UIOption, UICancelOption)	將目錄複製至其他目錄。

CopyDirectory(String, String)

將目錄複製至其他目錄。

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

public void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName);

member this.CopyDirectory : string * string -> unit

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

參數

sourceDirectoryName

String

要複製的目錄。

destinationDirectoryName

String

要複製目錄的目標位置。

例外狀況

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為您想要複製之目錄的路徑和名稱，以及您想要複製它的位置。

備註

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

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

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

收件者	請參閱
複製目錄	作法：將目錄複製到另一個目錄

另請參閱

• UICancelOption
• 物件 (Visual Basic)
• 如何：在 Visual Basic 中取得目錄的檔案集合
• 如何：在 Visual Basic 中剖析檔案路徑

CopyDirectory(String, String, UIOption)

將目錄複製至其他目錄。

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

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

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

Public 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", True)

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

備註

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

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

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

收件者	請參閱
複製目錄	作法：將目錄複製到另一個目錄

另請參閱

• UICancelOption
• 物件 (Visual Basic)
• 如何：在 Visual Basic 中取得目錄的檔案集合
• 如何：在 Visual Basic 中剖析檔案路徑

CopyDirectory(String, String, Boolean)

將目錄複製至其他目錄。

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

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

member this.CopyDirectory : string * string * bool -> unit

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

收件者	請參閱
複製目錄	作法：將目錄複製到另一個目錄

另請參閱

• UICancelOption
• 物件 (Visual Basic)
• 如何：在 Visual Basic 中取得目錄的檔案集合
• 如何：在 Visual Basic 中剖析檔案路徑

CopyDirectory(String, String, UIOption, UICancelOption)

將目錄複製至其他目錄。

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

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

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

Public 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", True)

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

備註

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

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

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

收件者	請參閱
複製目錄	作法：將目錄複製到另一個目錄

另請參閱

• UICancelOption
• 物件 (Visual Basic)
• 如何：在 Visual Basic 中取得目錄的檔案集合
• 如何：在 Visual Basic 中剖析檔案路徑