My.Computer.FileSystem.RenameFile 方法

更新：2007 年 11 月

重新命名檔案。

 ' Usage My.Computer.FileSystem.RenameFile(file ,newName) ' Declaration Public Sub RenameFile( _    ByVal file As String, _    ByVal newName As String _ )

參數

• file
  String。要重新命名的檔案。必要項。

• newName
  String。檔案的新名稱。必要項。

例外狀況

下列情形可能會造成例外狀況：

• 因下列其中一項原因而導致路徑無效：它是長度為零的字串、它只包含空白字元、它包含無效的字元，或者它是裝置路徑 (開頭為 \\.\) (ArgumentException)。

• newName 參數包含路徑資訊，或以反斜線 (\) 結束 (ArgumentException)。

• 路徑無效，因為它是 Nothing (ArgumentNullException)。

• newName 參數為 Nothing 或空字串 (ArgumentNullException)。

• 原始程式檔無效或不存在 (FileNotFoundException)。

• 已有 newName 中所指定之名稱的檔案或目錄 (IOException)。

• 路徑超過系統定義的最大長度 (PathTooLongException)。

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

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

• 使用者未具備必要的使用權限 (UnauthorizedAccessException)。

備註

不能使用此方法來移動檔案，請使用 My.Computer.FileSystem.MoveFile 方法移動及重新命名檔案。

工作

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

若要	請參閱
重新命名檔案	HOW TO：在 Visual Basic 中重新命名檔案

範例

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

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

將 "C:\Test.txt" 變成您要重新命名之檔案的路徑與檔名。

需求

命名空間：Microsoft.VisualBasic.MyServices

類別：FileSystemProxy (提供對 FileSystem 的存取)

組件：Visual Basic 執行階段程式庫 (在 Microsoft.VisualBasic.dll 中)

依專案類型的可用性

專案類型	是否可用
Windows 應用程式	是
類別庫	是
主控台應用程式	是
Windows 控制項程式庫	是
Web 控制項程式庫	是
Windows 服務	是
網站	是

使用權限

下列使用權限可能為必要：

使用權限	描述
FileIOPermission	控制存取檔案和資料夾的功能。關聯的列舉型別：Unrestricted。

如需詳細資訊，請參閱程式碼存取安全性和要求使用權限。

請參閱

參考

My.Computer.FileSystem 物件

FileSystem.RenameFile

其他資源

在 Visual Basic 中建立、刪除和移動檔案和目錄