My.Computer.FileSystem.MoveDirectory 方法

發行項
08/21/2008

更新：2007 年 11 月

將目錄從某個位置移到另一個位置。

 ' Usage My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName) My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,overwrite) My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,showUI) My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,showUI ,onUserCancel)  ' Declaration Public Sub MoveDirectory( _    ByVal sourceDirectoryName As String, _    ByVal destinationDirectoryName As String _ ) ' -or- Public Sub MoveDirectory( _    ByVal sourceDirectoryName As String, _    ByVal destinationDirectoryName As String, _    ByVal overwrite As Boolean _ ) ' -or- Public Sub MoveDirectory( _    ByVal sourceDirectoryName As String, _    ByVal destinationDirectoryName As String, _    ByVal showUI As UIOption _ ) ' -or- Public Sub MoveDirectory( _    ByVal sourceDirectoryName As String, _    ByVal destinationDirectoryName As String, _    ByVal showUI As UIOption, _    ByVal onUserCancel As UICancelOption _ )

參數

sourceDirectoryName
String：要移動之目錄的路徑。必要項。
destinationDirectoryName
String：要移動來源目錄的目標目錄路徑。必要項。
overwrite
Boolean：指定是否應該覆寫現有的目錄。預設值為 False。必要項。
showUI
UIOption：指定是否視覺化追蹤作業的進度。預設值為 UIOption.OnlyErrorDialogs。必要項。
onUserCancel
UICancelOption 列舉型別：指定當使用者取消作業時，是否擲回例外狀況。預設值為 UICancelOption.ThrowException。必要項。

例外狀況

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

路徑是長度為零的字串、只包含泛空白字元 (White Space)、包含無效的字元，或者路徑是裝置路徑 (開頭為 \\.\) (ArgumentException)。
路徑是 Nothing (ArgumentNullException)。
來源無效 (DirectoryNotFoundException)。
來源是根目錄 (IOException)。
組合路徑會指向現有的檔案 (IOException)。
來源路徑和目標路徑相同 (IOException)。
檔案已存在且 overwrite 設為 False (IOException)。
onUserCancel 設為 ThrowException，且無法複製檔案的子目錄 (IOException)。
作業是循環的 (InvalidOperationException)。
路徑中的檔案名稱或目錄名稱含有冒號 (:) (NotSupportedException)。
UICancelOption 設為 ThrowException，而且使用者會取消作業，或是無法完成作業 (OperationCanceledException)。
路徑超過系統定義的最大長度 (PathTooLongException)。
UICancelOption 設為 ThrowException，而且使用者缺少必要的使用權限 (SecurityException)。
使用者沒有修改檔案的使用權限 (UnauthorizedAccessException)。

備註

如果嘗試移動不存在目錄內的目錄，將會建立目標結構。

工作

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

若要	請參閱
移動目錄	HOW TO：在 Visual Basic 中移動目錄

範例

這個範例會將 Directory1 移入 Directory2。

My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2")

這個範例會將 Directory1 移入 Directory2，如果它已經存在，即覆寫該目錄。

My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2", _
True)

需求

命名空間 (Namespace)︰Microsoft.VisualBasic.MyServices

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

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

依專案類型的可用性

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

使用權限

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

使用權限	描述
FileIOPermission	控制存取檔案和資料夾的功能。關聯的列舉型別：Unrestricted。
UIPermission	控制與使用者介面和剪貼簿相關的使用權限。關聯的列舉型別：SafeSubWindows。