FileSystem.CopyDirectory 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將目錄內容複製到另一個目錄。
多載
| 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 -> unitPublic Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String)參數
- sourceDirectoryName
- String
要複製的目錄。
- destinationDirectoryName
- String
要複製目錄內容的目標位置。
例外狀況
路徑無效，原因如下：它是長度為零的字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) 。
destinationDirectoryName 或 sourceDirectoryName 為 Nothing 或空字串。
來源目錄不存在。
來源路徑和目標路徑相同。
作業是循環的。
路徑超過系統定義的最大長度。
路徑中的資料夾名稱含有冒號 (:)，或者是無效的格式。
使用者缺乏必要的使用權限來檢視路徑。
目的檔案存在，但無法存取它。
範例
下列範例會將目錄 TestDirectory1 的內容複製到 TestDirectory2。
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2")
將和 C:\TestDirectory2 取代C:\TestDirectory1為您想要複製之目錄的路徑和名稱，以及您想要複製它的位置。
備註
這個方法會將來源目錄的內容複製到目標目錄。 如果目標目錄不存在，則會建立它。 如果目標位置中有同名的目錄，則會合併兩個目錄的內容。 您可以在作業期間指定目錄的新名稱。
複製目錄中的檔案時，可能會擲回特定檔案所造成的例外狀況。 擲回這類例外狀況時，這些例外狀況會合併成單一例外狀況，其 Data 屬性會以索引鍵或目錄路徑的形式 IDictionary 保存專案，而特定例外狀況訊息會包含在對應的值中。 使用 For…Each 來列舉專案。
下表列出涉及 My.Computer.FileSystem.CopyDirectory 方法的工作範例。
| 收件者 | 請參閱 |
|---|---|
| 複製目錄 | 如何：在 Visual Basic 中將目錄複製到另一個目錄 |
另請參閱
適用於
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 -> unitPublic Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption)參數
- sourceDirectoryName
- String
要複製的目錄。
- destinationDirectoryName
- String
要複製目錄內容的目標位置。
- showUI
- UIOption
是否要以視覺方式追蹤作業進度。 預設為 UIOption.OnlyErrorDialogs。
例外狀況
路徑無效，原因如下：它是長度為零的字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) 。
destinationDirectoryName 或 sourceDirectoryName 為 Nothing 或空字串。
來源目錄不存在。
來源路徑和目標路徑相同。
作業是循環的。
路徑超過系統定義的最大長度。
路徑中的資料夾名稱含有冒號 (:)，或者是無效的格式。
使用者缺乏必要的使用權限來檢視路徑。
目的檔案存在，但無法存取它。
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 中將目錄複製到另一個目錄 |
另請參閱
適用於
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 -> unitPublic Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, overwrite As Boolean)參數
- sourceDirectoryName
- String
要複製的目錄。
- destinationDirectoryName
- String
要複製目錄內容的目標位置。
- overwrite
- Boolean
若要覆寫現有檔案，則為 True，否則為 False。 預設為 False。
例外狀況
路徑無效，原因如下：它是長度為零的字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) 。
destinationDirectoryName 或 sourceDirectoryName 為 Nothing 或空字串。
來源目錄不存在。
來源路徑和目標路徑相同。
作業是循環的。
路徑超過系統定義的最大長度。
路徑中的資料夾名稱含有冒號 (:)，或者是無效的格式。
使用者缺乏必要的使用權限來檢視路徑。
目的檔案存在，但無法存取它。
範例
下列範例會將目錄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 中將目錄複製到另一個目錄 |
另請參閱
適用於
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 -> unitPublic 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。
例外狀況
路徑無效，原因如下：它是長度為零的字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) 。
destinationDirectoryName 或 sourceDirectoryName 為 Nothing 或空字串。
來源目錄不存在。
來源路徑和目標路徑相同。
作業是循環的。
路徑超過系統定義的最大長度。
路徑中的資料夾名稱含有冒號 (:)，或者是無效的格式。
使用者缺乏必要的使用權限來檢視路徑。
目的檔案存在，但無法存取它。
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 中將目錄複製到另一個目錄 |
另請參閱
適用於
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應