如何：在 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)。

请参见

任务

如何：在 Visual Basic 中移动文件

如何：在同一目录中创建文件副本 (Visual Basic)

如何：在 Visual Basic 中在不同的目录中创建文件的副本

参考

RenameFile

其他资源

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