FileSystem.Rename(String, String) 方法

定义

命名空间:

Microsoft.VisualBasic

程序集:

Microsoft.VisualBasic.Core.dll

Source:

FileSystem.vb

重命名磁盘文件或目录。 相比 Rename，My 功能可使文件 I/O 操作的效率更高、性能更好。 有关详细信息，请参阅 FileSystem。

public:
 static void Rename(System::String ^ OldPath, System::String ^ NewPath);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void Rename (string OldPath, string NewPath);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Rename : string * string -> unit

Public Sub Rename (OldPath As String, NewPath As String)

参数

OldPath

String

必需。 指定现有文件名和位置的字符串表达式。 OldPath 可包含文件的目录和驱动器。

NewPath

String

必需。 指定新文件名和位置的字符串表达式。 NewPath 可包含目标位置的目录和驱动器。 NewPath 指定的文件名不能是已存在的文件名。

属性

SupportedOSPlatformAttribute

例外

ArgumentException

路径无效。

FileNotFoundException

OldPath 文件不存在。

IOException

无法重命名为不同的设备。

示例

此示例使用 Rename 函数重命名文件。 就此示例而言，假定指定的目录已存在。

Dim OldName, NewName As String
OldName = "OLDFILE"
' Define file names.
NewName = "NEWFILE"
' Rename file.
Rename(OldName, NewName)

OldName = "C:\OLDDIR\OLDFILE"
NewName = "C:\NEWDIR\NEWFILE"
' Move and rename file.
Rename(OldName, NewName)

注解

此Rename 函数将重命名文件，并将其移动到其他目录（如果需要）。 函数Rename可以跨驱动器移动文件，但仅当 和 OldPath 都NewPath位于同一驱动器上时，它才能重命名现有目录。 Rename 无法创建新的文件或目录。

对 Rename 打开的文件使用 函数会产生错误。 在重命名之前，必须关闭打开的文件。 Rename 参数不能包含多字符 (*) 和单字符 (？) 通配符。

重要

使用 Rename 将文件从未受保护的位置复制到受保护位置时，该文件保留较少限制的权限。 检查以确保不会引入可能的安全风险。

另请参阅

• Kill(String)
• ArgumentException
• FileNotFoundException
• IOException
• 如何：在 Visual Basic 中重命名文件