My.Computer.FileSystem.MoveDirectory 方法

项目
08/18/2008

更新：2007 年 11 月

将目录从一个位置移到另一个位置。

' Usage
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName)
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,overwrite)
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,showUI)
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,showUI ,onUserCancel)

' Declaration
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String _
)
' -or-
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal showUI As UIOption _
)
' -or-
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal showUI As UIOption, _
   ByVal onUserCancel As UICancelOption _
)

参数

sourceDirectoryName
String。要移动的目录的路径。必选。
destinationDirectoryName
String。要将源目录移动到的目录的路径。必选。
overwrite
Boolean。指定是否应覆盖现有目录。默认值为 False。必选。
showUI
UIOption。指定是否以可视的形式跟踪操作的进度。默认值为 UIOption.OnlyErrorDialogs。必选。
onUserCancel
UICancelOption 枚举。指定在用户取消该操作时是否引发异常。默认值为 UICancelOption.ThrowException。必选。

异常

以下情况可能会导致异常：

路径是零长度字符串、只包含空白、包含无效字符或者是设备路径（以 \\.\ 开头）(ArgumentException)。
路径为 Nothing (ArgumentNullException)。
源无效 (DirectoryNotFoundException)。
源是一个根目录 (IOException)。
组合路径指向某个现有文件 (IOException)。
源路径和目标路径相同 (IOException)。
该文件已存在，并且 overwrite 设置为 False (IOException)。
onUserCancel 设置为 ThrowException，并且无法复制子目录中的文件 (IOException)。
操作为循环 (InvalidOperationException)。
此路径中的文件名或目录名包含冒号 (:) (NotSupportedException)。
UICancelOption 设置为 ThrowException，并且用户取消了该操作，或者无法完成该操作 (OperationCanceledException)。
路径超过了系统定义的最大长度 (PathTooLongException)。
UICancelOption 设置为 ThrowException，并且用户缺少必要的权限 (SecurityException)。
用户没有修改该文件的权限 (UnauthorizedAccessException)。

备注

如果试图将目录移入一个并不存在的目录中，则将创建目标结构。

任务

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

要执行的操作	请参见
移动目录	如何：在 Visual Basic 中移动目录

示例

此示例将 Directory1 移到 Directory2 内。

My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2")

此示例将 Directory1 移到 Directory2 内，并且在该目录已存在时覆盖它。

My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2", _
True)

要求

命名空间：Microsoft.VisualBasic.MyServices

类：FileSystemProxy（提供对 FileSystem 的访问）

**程序集：**Visual Basic 运行库（位于 Microsoft.VisualBasic.dll 中）

不同项目类型的可用性

项目类型	是否可用
Windows 应用程序	是
类库	是
控制台应用程序	是
Windows 控件库	是
Web 控件库	是
Windows 服务	是
网站	是

权限

可能需要下列权限：

权限	说明
FileIOPermission	控制访问文件和文件夹的能力。关联的枚举：Unrestricted。
UIPermission	控制与用户界面和剪贴板相关的权限。关联的枚举：SafeSubWindows。