FileSystem.Rename(String, String) 方法

定義

命名空間:
Microsoft.VisualBasic
組件:
Microsoft.VisualBasic.dll

重新命名磁碟檔案或目錄。 這個 My 功能能讓你在檔案 I/O 操作 Rename中提升生產力和效能。 如需詳細資訊，請參閱FileSystem。

public:
 static void Rename(System::String ^ OldPath, System::String ^ NewPath);
public static void Rename(string OldPath, string NewPath);
static member Rename : string * string -> unit
Public Sub Rename (OldPath As String, NewPath As String)

參數

OldPath
String

必須的。 一個字串表達式，用來指定現有的檔案名稱和位置。 OldPath 可能包含檔案的目錄和磁碟機。

NewPath
String

必須的。 一個字串表達式，用來指定新的檔案名稱和位置。 NewPath 可能包含目的地地點的目錄和磁碟機。 所指定的 NewPath 檔名不可能已經存在。

例外狀況

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 函式可以跨硬碟移動檔案，但只有在 NewPath 和 OldPath 都位於同一磁碟上時，才能重新命名現有目錄。 Rename 無法建立新的檔案或目錄。

在開啟的檔案上使用這個 Rename 函式會產生錯誤。 你必須關閉未完成的檔案才能重新命名。 Rename 參數不得包含多字元（*）和單字元（？）萬用字元。

Important

當使用 Rename 檔案從未受保護的位置複製到受保護地點時，該檔案保留較少限制的權利。 檢查是否會帶來潛在的安全風險。

適用於

另請參閱