My.Computer.FileSystem.RenameDirectory 方法

更新：2007 年 11 月

重新命名目錄。

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

參數

• directory
  String。要重新命名之目錄的路徑與名稱。必要項。

• newName
  String。目錄的新名稱。必要項。

例外狀況

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

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

• newName 含有路徑資訊 (ArgumentException)。

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

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

• 原始目錄無效或不存在 (DirectoryNotFoundException)。

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

• 目錄為根目錄 (IOException)。

• 路徑長度超過 248 個字元 (PathTooLongException)。

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

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

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

備註

無法使用此方法移動目錄，請使用 MoveDirectory 方法移動及重新命名目錄。

工作

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

範例

此範例會將 Test 目錄重新命名為 SecondTest。

My.Computer.FileSystem.RenameDirectory("C:MyDocuments\Test", "SecondTest")

需求

命名空間：Microsoft.VisualBasic.MyServices

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

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

依專案類型的可用性

使用權限

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

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

請參閱

工作

HOW TO：在 Visual Basic 中剖析檔案路徑

參考

My.Computer.FileSystem 物件

RenameDirectory

My.Computer.FileSystem.MoveDirectory 方法

其他資源

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