FileSystem.MoveFile 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將檔案移至新的位置。
多載
| MoveFile(String, String) |
將檔案移至新的位置。 |
| MoveFile(String, String, UIOption) |
將檔案移至新的位置。 |
| MoveFile(String, String, Boolean) |
將檔案移至新的位置。 |
| MoveFile(String, String, UIOption, UICancelOption) |
將檔案移至新的位置。 |
MoveFile(String, String)
將檔案移至新的位置。
public:
static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);public static void MoveFile (string sourceFileName, string destinationFileName);static member MoveFile : string * string -> unitPublic Shared Sub MoveFile (sourceFileName As String, destinationFileName As String)參數
- sourceFileName
- String
要移動的檔案其路徑。
- destinationFileName
- String
要移入檔案之目錄的路徑。
例外狀況
路徑無效，原因如下：它是零長度字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) ;結尾為尾端斜線。
destinationFileName 為 Nothing 或空字串。
來源檔案無效或不存在。
檔案正由另一個程序使用中，或發生 I/O 錯誤。
路徑超過系統定義的最大長度。
路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式。
使用者缺乏必要的使用權限來檢視路徑。
範例
本範例會將檔案 Test.txt 從 TestDir1TestDir2移至 。
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
本範例會將檔案 Test.txt 從 TestDir1TestDir2 移至 ，並將其重新命名為 Test2.txt。
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
備註
如果目標結構不存在，則會建立它。
只有在MoveFile移動相同磁碟區內的檔案時，方法才會保留 ACE (存取控制 Entries) 。 這包括繼承的 ACE，這會在移動 (直接 ACE 時變成直接 ACE，優先於繼承的 ACE) 。 如果檔案在磁碟區之間移動，將不會複製 ACE。
下表列出涉及 My.Computer.FileSystem.MoveFile 方法的工作範例。
| 收件者 | 請參閱 |
|---|---|
| 移動檔案 | 如何：在 Visual Basic 中移動檔案 |
適用於
MoveFile(String, String, UIOption)
將檔案移至新的位置。
public:
static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);public static void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);static member MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unitPublic Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)參數
- sourceFileName
- String
要移動的檔案其路徑。
- destinationFileName
- String
要移入檔案之目錄的路徑。
- showUI
- UIOption
指定是否要以視覺方式追蹤作業進度。 預設為 UIOption.OnlyErrorDialogs。
例外狀況
路徑無效，原因如下：它是零長度字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) ;結尾為尾端斜線。
destinationFileName 為 Nothing 或空字串。
來源檔案無效或不存在。
檔案正由另一個程序使用中，或發生 I/O 錯誤。
路徑超過系統定義的最大長度。
路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式。
使用者缺乏必要的使用權限來檢視路徑。
範例
本範例會將檔案 Test.txt 從 TestDir1TestDir2移至 。
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
本範例會將檔案 Test.txt 從 TestDir1TestDir2 移至 ，並將其重新命名為 Test2.txt。
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
備註
如果目標結構不存在，則會建立它。
只有在MoveFile移動相同磁碟區內的檔案時，方法才會保留 ACE (存取控制 Entries) 。 這包括繼承的 ACE，這會在移動 (直接 ACE 時變成直接 ACE，優先於繼承的 ACE) 。 如果檔案在磁碟區之間移動，將不會複製 ACE。
下表列出涉及 My.Computer.FileSystem.MoveFile 方法的工作範例。
| 收件者 | 請參閱 |
|---|---|
| 移動檔案 | 如何：在 Visual Basic 中移動檔案 |
另請參閱
適用於
MoveFile(String, String, Boolean)
將檔案移至新的位置。
public:
static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);public static void MoveFile (string sourceFileName, string destinationFileName, bool overwrite);static member MoveFile : string * string * bool -> unitPublic Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)參數
- sourceFileName
- String
要移動的檔案其路徑。
- destinationFileName
- String
要移入檔案之目錄的路徑。
- overwrite
- Boolean
若要覆寫現有檔案，則為 True，否則為 False。 預設為 False。
例外狀況
路徑無效，原因如下：它是零長度字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) ;結尾為尾端斜線。
destinationFileName 為 Nothing 或空字串。
來源檔案無效或不存在。
檔案正由另一個程序使用中，或發生 I/O 錯誤。
路徑超過系統定義的最大長度。
路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式。
使用者缺乏必要的使用權限來檢視路徑。
範例
本範例會將檔案 Test.txt 從 TestDir1TestDir2移至 。
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
本範例會將檔案 Test.txt 從 TestDir1TestDir2 移至 ，並將其重新命名為 Test2.txt。
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
備註
如果目標結構不存在，則會建立它。
只有在MoveFile移動相同磁碟區內的檔案時，方法才會保留 ACE (存取控制 Entries) 。 這包括繼承的 ACE，這會在移動 (直接 ACE 時變成直接 ACE，優先於繼承的 ACE) 。 如果檔案在磁碟區之間移動，將不會複製 ACE。
下表列出涉及 My.Computer.FileSystem.MoveFile 方法的工作範例。
| 收件者 | 請參閱 |
|---|---|
| 移動檔案 | 如何：在 Visual Basic 中移動檔案 |
適用於
MoveFile(String, String, UIOption, UICancelOption)
將檔案移至新的位置。
public:
static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);public static void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);static member MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unitPublic Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)參數
- sourceFileName
- String
要移動的檔案其路徑。
- destinationFileName
- String
要移入檔案之目錄的路徑。
- showUI
- UIOption
指定是否要以視覺方式追蹤作業進度。 預設為 UIOption.OnlyErrorDialogs。
- onUserCancel
- UICancelOption
指定是否在使用者取消作業時擲回例外狀況。 預設為 UICancelOption.ThrowException。
例外狀況
路徑無效，原因如下：它是零長度字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) ;結尾為尾端斜線。
destinationFileName 為 Nothing 或空字串。
來源檔案無效或不存在。
檔案正由另一個程序使用中，或發生 I/O 錯誤。
onUserCancel 設定為 ThrowException，而且使用者已取消作業或發生未指定的 I/O 錯誤。
路徑超過系統定義的最大長度。
路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式。
使用者缺乏必要的使用權限來檢視路徑。
範例
本範例會將檔案 Test.txt 從 TestDir1TestDir2移至 。
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
本範例會將檔案 Test.txt 從 TestDir1TestDir2 移至 ，並將其重新命名為 Test2.txt。
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
備註
如果目標結構不存在，則會建立它。
只有在MoveFile移動相同磁碟區內的檔案時，方法才會保留 ACE (存取控制 Entries) 。 這包括繼承的 ACE，這會在移動 (直接 ACE 時變成直接 ACE，優先於繼承的 ACE) 。 如果檔案在磁碟區之間移動，將不會複製 ACE。
下表列出涉及 My.Computer.FileSystem.MoveFile 方法的工作範例。
| 收件者 | 請參閱 |
|---|---|
| 移動檔案 | 如何：在 Visual Basic 中移動檔案 |
