共用方式為


FileSystem.Rename(String, String) 方法

定義

重新命名磁碟的檔案或目錄。 相較於 RenameMy 功能可提升檔案 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 -> unit
static member Rename : string * string -> unit
Public 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 將檔案從未受保護的位置複製到受保護的位置時,檔案會保留較不受限的許可權。 請檢查以確定您並未引入可能的安全性風險。

適用於

另請參閱