FileSystem.Rename(String, String) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重命名磁盘文件或目录。 相比 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);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可以跨驱动器移动文件，但仅当 和 OldPath 都NewPath位于同一驱动器上时，它才能重命名现有目录。
Rename 无法创建新的文件或目录。
对 Rename 打开的文件使用 函数会产生错误。 在重命名之前，必须关闭打开的文件。
Rename 参数不能包含多字符 (*) 和单字符 (？) 通配符。
重要
使用 Rename 将文件从未受保护的位置复制到受保护位置时，该文件保留较少限制的权限。 检查以确保不会引入可能的安全风险。
