更新:2007 年 11 月
使用 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 代码段。在代码段选择器中,代码段位于“文件系统 - 处理驱动器、文件夹和文件”内。有关更多信息,请参见如何:在代码中插入代码段 (Visual Basic)。
可靠编程
以下情况可能会导致异常:
- 路径由于以下原因之一而无效:它是零长度字符串;它仅包含空白;它包含无效字符;或者它是一个设备路径(以 \\.\ 开头)(ArgumentException)。 
- newName 包含路径信息 (ArgumentException)。 
- 路径无效,因为它是 Nothing (ArgumentNullException)。 
- newName 为 Nothing 或为空字符串 (ArgumentNullException)。 
- 源文件无效或不存在 (FileNotFoundException)。 
- 存在一个具有 newName 中指定的名称的文件或目录 (IOException)。 
- 路径超过了系统定义的最大长度 (PathTooLongException)。 
- 路径中的文件名或目录名包含冒号 (:),或格式无效 (NotSupportedException)。 
- 该用户缺少查看该路径所必需的权限 (SecurityException)。 
- 该用户没有必需的权限 (UnauthorizedAccessException)。 
请参见
任务
如何:在同一目录中创建文件副本 (Visual Basic)
如何:在 Visual Basic 中在不同的目录中创建文件的副本
参考
My.Computer.FileSystem.RenameFile 方法