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 中)
依專案類型的可用性
專案類型 |
是否可用 |
|---|---|
Windows 應用程式 |
是 |
類別庫 |
是 |
主控台應用程式 |
是 |
Windows 控制項程式庫 |
是 |
Web 控制項程式庫 |
是 |
Windows 服務 |
是 |
網站 |
是 |
使用權限
下列使用權限可能為必要：
使用權限 |
描述 |
|---|---|
控制存取檔案和資料夾的功能。關聯的列舉型別：Unrestricted。 |
請參閱
工作
參考
My.Computer.FileSystem.MoveDirectory 方法