FileSystem.RenameFile(String, String) 方法

定義

命名空間:

Microsoft.VisualBasic.FileIO

組件:

Microsoft.VisualBasic.Core.dll

來源:

FileSystem.vb

重新命名檔案。

public:
 static void RenameFile(System::String ^ file, System::String ^ newName);

public static void RenameFile (string file, string newName);

static member RenameFile : string * string -> unit

Public Shared Sub RenameFile (file As String, newName As String)

參數

file

String

要重新命名的檔案。

newName

String

檔案的新名稱。

例外狀況

ArgumentException

newName 包含路徑資訊，或結尾為反斜杠 (\) 。

ArgumentNullException

file 為 Nothing。

-或-

newName 為 Nothing 或空字串。

FileNotFoundException

目錄不存在。

IOException

已存在 newName 中所指定之名稱的檔案或目錄。

PathTooLongException

路徑超過系統定義的最大長度。

NotSupportedException

路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式。

SecurityException

使用者缺乏必要的使用權限來檢視路徑。

UnauthorizedAccessException

使用者未具備必要的使用權限。

範例

這個範例會將檔案 Test.txt 重新命名為 SecondTest.txt。

My.Computer.FileSystem.RenameFile("C:\Test.txt", "SecondTest.txt")

將 「C:\Test.txt變更為您要重新命名之檔案的路徑和檔名。

備註

這個方法無法用來移動檔案，請使用 MoveFile 方法來移動並重新命名檔案。

下表列出涉及 My.Computer.FileSystem.RenameFile 方法的工作範例。

收件者	請參閱
重新命名檔案	如何：在 Visual Basic 中重新命名檔案