FileSystem.Rename(String, String) 方法

定義

命名空間:

Microsoft.VisualBasic

組件:

Microsoft.VisualBasic.Core.dll

來源:

FileSystem.vb

重新命名磁碟的檔案或目錄。 相較於 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);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Rename : string * string -> unit

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

參數

OldPath

String

必要。 字串運算式，指定現有的檔案名稱和位置。 OldPath 可包括檔案的目錄及磁碟機。

NewPath

String

必要。 字串運算式，指定新檔案名稱與位置。 NewPath 可包括目的位置的目錄及磁碟機。 NewPath 指定的檔案名稱不能已經存在。

屬性

SupportedOSPlatformAttribute

例外狀況

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

在開啟的檔案上使用函 Rename 式會產生錯誤。 您必須先關閉開啟的檔案，再重新命名檔案。 Rename 自變數不能包含多字元 (*) 和單一字元 (？) 通配符。

重要

使用 Rename 將檔案從未受保護的位置複製到受保護的位置時，檔案會保留較不受限的許可權。 請檢查以確定您並未引入可能的安全性風險。

另請參閱

• Kill(String)
• ArgumentException
• FileNotFoundException
• IOException
• 如何：在 Visual Basic 中重新命名檔案