FileSystemProxy.CopyDirectory 方法

定义

将一个目录复制到另一个目录中。

重载

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

应将目录复制到的位置。

例外

由于以下原因之一,路径无效:它是一个长度为零的字符串;它只包含空格;它包含无效字符;或它是以 \\.\) 开头的设备路径 (。

destinationDirectoryNamesourceDirectoryNameNothing 或空字符串。

源目录不存在。

源路径和目标路径相同。

操作为循环。

路径超过了系统定义的最大长度。

路径中的文件夹名包含冒号 (:),或格式无效。

该用户缺少查看该路径所必需的权限。

目标文件存在但无法访问。

示例

以下示例将 目录 TestDirectory1 复制到 TestDirectory2,覆盖现有文件。

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

将 和 C:\TestDirectory2 替换为C:\TestDirectory1要复制的目录的路径和名称以及要将其复制到的位置。

注解

此方法复制目录的内容以及目录本身。 如果目标目录不存在,则会创建它。 如果目标位置中存在同名的目录,则会合并这两个目录的内容。 操作期间可为此目录指定新名称。

复制目录中的文件时,可能会引发由特定文件引起的异常。 引发此类异常时,它们将合并到单个异常中IDictionary,该异常的 Data 属性以 的形式保存项,其中文件或目录路径为键,特定异常消息包含在相应的值中。 使用 For…Each 枚举条目。

下表列出了涉及 My.Computer.FileSystem.CopyDirectory 方法的任务示例。

功能 查看
复制目录 如何:将目录复制到另一个目录

另请参阅

适用于

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

例外

由于以下原因之一,路径无效:它是一个长度为零的字符串;它只包含空格;它包含无效字符;或它是以 \\.\) 开头的设备路径 (。

destinationDirectoryNamesourceDirectoryNameNothing 或空字符串。

源目录不存在。

源路径和目标路径相同。

操作为循环。

路径超过了系统定义的最大长度。

路径中的文件夹名包含冒号 (:),或格式无效。

该用户缺少查看该路径所必需的权限。

目标文件存在但无法访问。

ShowUI 设置为 UIOption.AllDialogs 且用户取消了该操作,或者无法复制目录中的一个或多个文件。

示例

以下示例将 目录 TestDirectory1 复制到 TestDirectory2,覆盖现有文件。

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

将 和 C:\TestDirectory2 替换为C:\TestDirectory1要复制的目录的路径和名称以及要将其复制到的位置。

注解

此方法复制目录的内容以及目录本身。 如果目标目录不存在,则会创建它。 如果目标位置中存在同名的目录,则会合并这两个目录的内容。 操作期间可为此目录指定新名称。

复制目录中的文件时,可能会引发由特定文件引起的异常。 引发此类异常时,它们将合并到单个异常中IDictionary,该异常的 Data 属性以 的形式保存项,其中文件或目录路径为键,特定异常消息包含在相应的值中。 使用 For…Each 枚举条目。

下表列出了涉及 My.Computer.FileSystem.CopyDirectory 方法的任务示例。

功能 查看
复制目录 如何:将目录复制到另一个目录

另请参阅

适用于

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

例外

由于以下原因之一,路径无效:它是一个长度为零的字符串;它只包含空格;它包含无效字符;或它是以 \\.\) 开头的设备路径 (。

destinationDirectoryNamesourceDirectoryNameNothing 或空字符串。

源目录不存在。

源路径和目标路径相同。

操作为循环。

路径超过了系统定义的最大长度。

路径中的文件夹名包含冒号 (:),或格式无效。

该用户缺少查看该路径所必需的权限。

目标文件存在但无法访问。

示例

以下示例将 目录 TestDirectory1 复制到 TestDirectory2,覆盖现有文件。

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

将 和 C:\TestDirectory2 替换为C:\TestDirectory1要复制的目录的路径和名称以及要将其复制到的位置。

注解

此方法复制目录的内容以及目录本身。 如果目标目录不存在,则会创建它。 如果目标位置中存在同名的目录,则会合并这两个目录的内容。 操作期间可为此目录指定新名称。

复制目录中的文件时,可能会引发由特定文件引起的异常,例如在将 设置为 Falseoverwrite合并期间存在的文件。 引发此类异常时,它们将合并到单个异常中IDictionary,该异常的 Data 属性以 的形式保存项,其中文件或目录路径为键,特定异常消息包含在相应的值中。 使用 For…Each 枚举条目。

下表列出了涉及 My.Computer.FileSystem.CopyDirectory 方法的任务示例。

功能 查看
复制目录 如何:将目录复制到另一个目录

另请参阅

适用于

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

例外

路径无效,原因如下:它是零长度字符串;它仅包含空格;它包含无效字符;或它是以 \\.\) 开头 (设备路径。

destinationDirectoryNamesourceDirectoryNameNothing 或空字符串。

源目录不存在。

源路径和目标路径相同。

操作为循环。

路径超过了系统定义的最大长度。

路径中的文件夹名包含冒号 (:),或格式无效。

该用户缺少查看该路径所必需的权限。

目标文件存在但无法访问。

ShowUI 设置为 UIOption.AllDialogs 且用户取消了该操作,或者无法复制目录中的一个或多个文件。

示例

以下示例将 目录 TestDirectory1 复制到 TestDirectory2中,覆盖现有文件。

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

将 和 C:\TestDirectory2 替换为C:\TestDirectory1要复制的目录的路径和名称以及要复制到的位置。

注解

此方法复制目录的内容以及目录本身。 如果目标目录不存在,则会创建它。 如果目标位置中存在同名的目录,则会合并这两个目录的内容。 操作期间可为此目录指定新名称。

复制目录中的文件时,可能会引发由特定文件引起的异常。 当引发此类异常时,它们将合并为单个异常,其 Data 属性保存的形式的条目 IDictionary ,其中文件或目录路径是键,特定异常消息包含在相应的值中。 用于 For…Each 枚举各条目。

下表列出了涉及 My.Computer.FileSystem.CopyDirectory 方法的任务示例。

功能 查看
复制目录 如何:将目录复制到另一个目录

另请参阅

适用于