My.Computer.FileSystem.RenameDirectory 方法

更新：2007 年 11 月

重命名一个目录。

' Usage
My.Computer.FileSystem.RenameDirectory(directory ,newName)
' Declaration
Public Sub RenameDirectory( _
   ByVal directory As String, _
   ByVal newName As String _
)

参数

• directory
  String。要重命名的目录的路径和名称。必选。

• newName
  String。目录的新名称。必选。

异常

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

• 路径由于以下原因之一而无效：它是零长度字符串；它仅包含空白；它包含无效字符；或者它是一个设备路径（以 \\.\ 开头）(ArgumentException)。

• newName 参数包含路径信息 (ArgumentException)。

• 路径无效，因为它是 Nothing (ArgumentNullException)。

• newName 参数为 Nothing 或为空字符串 (ArgumentNullException)。

• 源目录无效或不存在 (DirectoryNotFoundException)。

• 有一个现有文件或目录使用 newName 中指定的名称 (IOException)。

• 目录是根目录 (IOException)。

• 路径超过 248 个字符 (PathTooLongException)。

• 路径中的文件名或目录名包含冒号 (:)，或格式无效 (NotSupportedException)。

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

• 该用户没有必需的权限 (UnauthorizedAccessException)。

备注

此方法不能用于移动目录；请使用 MoveDirectory 方法移动然后重命名该目录。

任务

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

要执行的操作	请参见
重命名一个目录	如何：在 Visual Basic 中重命名目录

示例

此示例将 Test 目录重命名为 SecondTest。

My.Computer.FileSystem.RenameDirectory("C:MyDocuments\Test", "SecondTest")

要求

命名空间：Microsoft.VisualBasic.MyServices

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

**程序集：**Visual Basic Runtime Library（位于 Microsoft.VisualBasic.dll 中）

按项目类型列出可用性

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

权限

以下权限可能是必需的：

权限	说明
FileIOPermission	控制访问文件和文件夹的能力。关联的枚举：Unrestricted。

有关更多信息，请参见代码访问安全性和请求权限。

请参见

任务

如何：在 Visual Basic 中分析文件路径

参考

My.Computer.FileSystem 对象

RenameDirectory

My.Computer.FileSystem.MoveDirectory 方法

其他资源

创建、删除和移动文件和目录 (Visual Basic)