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

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

示例

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

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

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

注解

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

复制目录中的文件时，可能会引发由特定文件引起的异常。 引发此类异常时，它们将合并到单个异常中IDictionary，该异常的 Data 属性以 的形式保存项，其中文件或目录路径为键，特定异常消息包含在相应的值中。 使用 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 且用户取消了该操作，或者无法复制目录中的一个或多个文件。

示例

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

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

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

注解

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

复制目录中的文件时，可能会引发由特定文件引起的异常。 引发此类异常时，它们将合并到单个异常中IDictionary，该异常的 Data 属性以 的形式保存项，其中文件或目录路径为键，特定异常消息包含在相应的值中。 使用 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

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

示例

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

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

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

注解

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

复制目录中的文件时，可能会引发由特定文件引起的异常，例如在将 设置为 False时overwrite合并期间存在的文件。 引发此类异常时，它们将合并到单个异常中IDictionary，该异常的 Data 属性以 的形式保存项，其中文件或目录路径为键，特定异常消息包含在相应的值中。 使用 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 且用户取消了该操作，或者无法复制目录中的一个或多个文件。

示例

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

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 中分析文件路径