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)

Source:

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)

Source:

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 且用户取消了该操作，或者无法复制目录中的一个或多个文件。

示例

以下示例将目录 TestDirectory1 的内容复制到 TestDirectory2中，显示进度对话框和任何错误对话框。

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)

Source:

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要复制的目录的路径和名称以及要复制到的位置。

注解

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

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

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

功能	查看
复制目录	如何：在 Visual Basic 中将一个目录复制到另一个目录

另请参阅

• UICancelOption

CopyDirectory(String, String, UIOption, UICancelOption)

Source:

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 且用户取消了该操作，或者无法复制目录中的一个或多个文件。

示例

以下示例将目录 TestDirectory1 的内容复制到 TestDirectory2中，显示进度对话框和任何错误对话框，如果用户在操作过程中单击“ 取消 ”，则不执行任何操作。

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