Rename 函式

發行項
08/21/2008

更新：2007 年 11 月

重新命名磁碟檔案或目錄。

My 功能在檔案 I/O 作業中的產能和效能勝過 Rename。如需詳細資訊，請參閱 My.Computer.FileSystem 物件。

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

參數

OldPath
必要項。String 運算式，指定現有的檔名和位置。OldPath 可能包含檔案的目錄和磁碟機。
NewPath
必要項。String 運算式，指定新的檔名和位置。NewPath 可能包含目的位置的目錄和磁碟機。不可存在 NewPath 所指定的檔名。

例外狀況

例外狀況類型	錯誤代碼	條件
ArgumentException	5	路徑無效。
FileNotFoundException	53	OldPath 檔案不存在。
IOException	58	NewPath 檔案已存在
IOException	75	存取無效。
IOException	74	無法重新命名為不同的裝置。

如果將使用非結構化錯誤處理的 Visual Basic 6.0 應用程式升級，請參閱「錯誤代碼」資料行 (您可以將錯誤代碼與 Number 屬性 (Err 物件) 比對)。但是，請盡可能考慮以 Visual Basic 的結構化例外處理概觀取代這類錯誤控制項。

備註

Rename 函式會重新命名檔案，並視需要將其移至不同的目錄。Rename 函式可在磁碟機間移動檔案，但在 NewPath 和 OldPath 位在相同磁碟機上時，它只可重新命名現有的目錄。Rename 無法建立新的檔案或目錄。

在開啟檔案上使用 Rename 函式會產生錯誤。重新命名開啟的檔案時，必須先將它關閉。Rename 引數不可包含多重字元 (*) 和單一字元 (?) 的萬用字元。

安全性注意事項：
使用 Rename 將檔案從未保護的位置複製到保護的位置時，檔案會保留最少的限制權限。請確認沒有引入可能的安全性風險。

範例

這個範例會使用 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)