FileSystem.MoveFile 方法

定義

命名空間:

Microsoft.VisualBasic.FileIO

組件:

Microsoft.VisualBasic.Core.dll

將檔案移至新的位置。

多載

MoveFile(String, String)	將檔案移至新的位置。
MoveFile(String, String, UIOption)	將檔案移至新的位置。
MoveFile(String, String, Boolean)	將檔案移至新的位置。
MoveFile(String, String, UIOption, UICancelOption)	將檔案移至新的位置。

MoveFile(String, String)

來源:

FileSystem.vb

將檔案移至新的位置。

public:
 static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);

public static void MoveFile (string sourceFileName, string destinationFileName);

static member MoveFile : string * string -> unit

Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String)

參數

sourceFileName

String

要移動的檔案其路徑。

destinationFileName

String

要移入檔案之目錄的路徑。

例外狀況

ArgumentException

路徑無效，原因如下：它是零長度字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) ;結尾為尾端斜線。

ArgumentNullException

destinationFileName 為 Nothing 或空字串。

FileNotFoundException

來源檔案無效或不存在。

IOException

檔案正由另一個程序使用中，或發生 I/O 錯誤。

PathTooLongException

路徑超過系統定義的最大長度。

NotSupportedException

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

SecurityException

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

範例

本範例會將檔案 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)

來源:

FileSystem.vb

將檔案移至新的位置。

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 -> unit

Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)

參數

sourceFileName

String

要移動的檔案其路徑。

destinationFileName

String

要移入檔案之目錄的路徑。

showUI

UIOption

指定是否要以視覺方式追蹤作業進度。 預設為 UIOption.OnlyErrorDialogs。

例外狀況

ArgumentException

路徑無效，原因如下：它是零長度字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) ;結尾為尾端斜線。

ArgumentNullException

destinationFileName 為 Nothing 或空字串。

FileNotFoundException

來源檔案無效或不存在。

IOException

檔案正由另一個程序使用中，或發生 I/O 錯誤。

PathTooLongException

路徑超過系統定義的最大長度。

NotSupportedException

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

SecurityException

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

範例

本範例會將檔案 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 中移動檔案

另請參閱

• UIOption

MoveFile(String, String, Boolean)

來源:

FileSystem.vb

將檔案移至新的位置。

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 -> unit

Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)

參數

sourceFileName

String

要移動的檔案其路徑。

destinationFileName

String

要移入檔案之目錄的路徑。

overwrite

Boolean

若要覆寫現有檔案，則為 True，否則為 False。 預設為 False。

例外狀況

ArgumentException

路徑無效，原因如下：它是零長度字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) ;結尾為尾端斜線。

ArgumentNullException

destinationFileName 為 Nothing 或空字串。

FileNotFoundException

來源檔案無效或不存在。

IOException

檔案正由另一個程序使用中，或發生 I/O 錯誤。

PathTooLongException

路徑超過系統定義的最大長度。

NotSupportedException

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

SecurityException

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

範例

本範例會將檔案 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)

來源:

FileSystem.vb

將檔案移至新的位置。

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 -> unit

Public 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。

例外狀況

ArgumentException

路徑無效，原因如下：它是零長度字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) ;結尾為尾端斜線。

ArgumentNullException

destinationFileName 為 Nothing 或空字串。

FileNotFoundException

來源檔案無效或不存在。

IOException

檔案正由另一個程序使用中，或發生 I/O 錯誤。

OperationCanceledException

onUserCancel 設定為 ThrowException，而且使用者已取消作業或發生未指定的 I/O 錯誤。

PathTooLongException

路徑超過系統定義的最大長度。

NotSupportedException

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

SecurityException

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

範例

本範例會將檔案 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 中移動檔案

另請參閱

• UIOption
• UICancelOption