My.Computer.FileSystem.RenameFile 方法

更新：2007 年 11 月

重命名一个文件。

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

参数

• file
  String。要重命名的文件。必选。

• newName
  String。文件的新名称。必选。

异常

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

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

• newName 参数包含路径信息或以反斜杠 (\) 结束 (ArgumentException)。

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

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

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

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

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

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

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

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

备注

此方法不能用于移动文件；请使用 My.Computer.FileSystem.MoveFile 方法移动然后重命名该文件。

任务

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

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

示例

此示例将文件 Test.txt 重命名为 SecondTest.txt。

My.Computer.FileSystem.RenameFile("C:\Test.txt", "SecondTest.txt")

将“C:\Test.txt”更改为要重命名文件的路径和文件名。

要求

命名空间：Microsoft.VisualBasic.MyServices

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

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

按项目类型列出可用性

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

权限

以下权限可能是必需的：

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

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

请参见

参考

My.Computer.FileSystem 对象

FileSystem.RenameFile

其他资源

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