FileSystem.RenameFile(String, String) 方法

定义

命名空间:

Microsoft.VisualBasic.FileIO

程序集:

Microsoft.VisualBasic.Core.dll

Source:

FileSystem.vb

重命名文件。

public:
 static void RenameFile(System::String ^ file, System::String ^ newName);

public static void RenameFile (string file, string newName);

static member RenameFile : string * string -> unit

Public Shared Sub RenameFile (file As String, newName As String)

参数

file

String

要重命名的文件。

newName

String

文件的新名称。

例外

ArgumentException

newName 包含路径信息，或者以反斜杠 (\) 结尾。

ArgumentNullException

file 为 Nothing。

- 或 -

newName 为 Nothing 或空字符串。

FileNotFoundException

该目录不存在。

IOException

存在一个具有 newName 中指定的名称的文件或目录。

PathTooLongException

路径超过了系统定义的最大长度。

NotSupportedException

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

SecurityException

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

UnauthorizedAccessException

该用户没有必需的权限。

示例

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

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

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

注解

此方法不能用于移动文件；使用 MoveFile 方法可移动并重命名文件。

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

功能	查看
重命名文件	如何：在 Visual Basic 中重命名文件