FileSystem.Rename 方法

重新命名磁碟的檔案或目錄。My 功能提供比 Rename 更強的檔案 I/O 作業產能和效能。如需詳細資訊，請參閱 My.Computer.FileSystem 物件。

命名空間： Microsoft.VisualBasic
組件： Microsoft.VisualBasic (在 microsoft.visualbasic.dll 中)

語法

'宣告
Public Shared Sub Rename ( _
    OldPath As String, _
    NewPath As String _
)
'用途
Dim OldPath As String
Dim NewPath As String

FileSystem.Rename(OldPath, NewPath)

public static void Rename (
    string OldPath,
    string NewPath
)

public:
static void Rename (
    String^ OldPath, 
    String^ NewPath
)

public static void Rename (
    String OldPath, 
    String NewPath
)

public static function Rename (
    OldPath : String, 
    NewPath : String
)

參數

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

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

備註

如需詳細資訊，請參閱 Visual Basic 的主題 Rename 函式。

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)

平台

Windows 98、 Windows 2000 SP4、 Windows Millennium Edition、 Windows Server 2003、 Windows XP Media Center Edition、 Windows XP Professional x64 Edition、 Windows XP SP2、 Windows XP Starter Edition

.NET Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱系統需求一節的內容。

版本資訊

.NET Framework

支援版本：2.0、1.1、1.0

請參閱

參考

FileSystem 類別
FileSystem 成員
Microsoft.VisualBasic 命名空間
ArgumentException Class
FileNotFoundException Class
IOException Class

其他資源

Rename 函式
Kill 函式
HOW TO：在 Visual Basic 中重新命名檔案
HOW TO：在 Visual Basic 中重新命名目錄