如何：在 Visual Basic 中重命名文件

使用 My.Computer.FileSystem 对象的 RenameFile 方法可通过提供当前位置、文件名和新文件名来重命名文件。 此方法不能用于移动文件；使用 MoveFile 方法可移动并重命名文件。

重命名文件

• 使用 My.Computer.FileSystem.RenameFile 方法可重命名文件。 此示例将名为 Test.txt 的文件重命名为 SecondTest.txt。

  ' Change "c:\test.txt" to the path and filename for the file that
  ' you want to rename.
  My.Computer.FileSystem.RenameFile("C:\Test.txt", "SecondTest.txt")
  

此代码示例也可作为 IntelliSense 代码片段。 在代码片段选取器中，该代码段位于“文件系统 - 处理驱动器、文件夹和文件”。 有关详细信息，请参阅代码片段。

可靠编程

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

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

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

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

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

• 源文件无效或不存在 (FileNotFoundException)。

• 不存在具有 newName (IOException) 中指定名称的现有文件或目录。

• 路径超过了系统定义的最大长度 (PathTooLongException)。

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

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

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

另请参阅

• RenameFile
• 如何：移动文件
• 创建、删除和移动文件和目录
• 如何：在同一目录中创建文件副本
• 如何：在不同的目录中创建文件的副本