FileSystem.Rename(String, String) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重命名磁盘文件或目录。 此功能 My 可让你在文件 I/O 操作 Rename中提高工作效率和性能。 有关详细信息，请参阅 FileSystem。
public:
static void Rename(System::String ^ OldPath, System::String ^ NewPath);[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void Rename(string OldPath, string NewPath);public static void Rename(string OldPath, string NewPath);[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Rename : string * string -> unitstatic member Rename : string * string -> unitPublic Sub Rename (OldPath As String, NewPath As String)参数
- OldPath
- String
必填。 一个指定现有文件名和位置的字符串表达式。
OldPath 可以包含文件的目录和驱动器。
- NewPath
- String
必填。 一个指定新文件名和位置的字符串表达式。
NewPath 可能包括目标位置的目录和驱动器。 指定的 NewPath 文件名尚不存在。
- 属性
例外
路径无效。
OldPath 文件不存在。
无法重命名为不同的设备。
示例
此示例使用 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函数可以在驱动器之间移动文件，但只能在两者位于NewPathOldPath同一驱动器上时重命名现有目录。
Rename 无法创建新文件或目录。
在 Rename 打开的文件中使用该函数会产生错误。 在重命名该文件之前，必须关闭打开的文件。
Rename 参数不能包含多字符 \ 和单字符 （？） 通配符。
Important
当用于 Rename 将文件从未受保护的位置复制到受保护位置时，该文件将保留限制较少的权限。 检查以确保不会引入可能的安全风险。
