FileSystemProxy.MoveFile 方法

定義

命名空間:

Microsoft.VisualBasic.MyServices

組件:

Microsoft.VisualBasic.Forms.dll

將檔案移至新的位置。

多載

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

MoveFile(String, String)

將檔案移至新的位置。

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

public void MoveFile (string sourceFileName, string destinationFileName);

member this.MoveFile : string * string -> unit

Public 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 從 TestDir1 移至 TestDir2。

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

本範例會將檔案Test.txt從 TestDir1 移至 TestDir2 ，並將其重新命名。Test2.txt

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

備註

如果目標結構不存在，則會建立它。

只有在MoveFile移動相同磁碟區內的檔案時，方法才會保留 ACE (存取控制 專案) 。 這包括繼承的 ACE，在行動 (直接 ACE 時，會優先於繼承的 ACE) 。 如果檔案在磁碟區之間移動，則不會複製 ACE。

下表列出涉及 My.Computer.FileSystem.MoveFile 方法的工作範例。

收件者	請參閱
移動檔案	作法：移動檔案

另請參閱

• 物件 (Visual Basic)
• 在 Visual Basic 中建立、刪除和移動檔案和目錄

MoveFile(String, String, UIOption)

將檔案移至新的位置。

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);

public void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);

member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit

Public 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 從 TestDir1 移至 TestDir2。

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

本範例會將檔案Test.txt從 TestDir1 移至 TestDir2 ，並將其重新命名。Test2.txt

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

備註

如果目標結構不存在，則會建立它。

只有在MoveFile移動相同磁碟區內的檔案時，方法才會保留 ACE (存取控制 專案) 。 這包括繼承的 ACE，在行動 (直接 ACE 時，會優先於繼承的 ACE) 。 如果檔案在磁碟區之間移動，則不會複製 ACE。

下表列出涉及 My.Computer.FileSystem.MoveFile 方法的工作範例。

收件者	請參閱
移動檔案	作法：移動檔案

另請參閱

• UIOption
• 物件 (Visual Basic)
• 在 Visual Basic 中建立、刪除和移動檔案和目錄

MoveFile(String, String, Boolean)

將檔案移至新的位置。

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

public void MoveFile (string sourceFileName, string destinationFileName, bool overwrite);

member this.MoveFile : string * string * bool -> unit

Public 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 從 TestDir1 移至 TestDir2。

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

本範例會將檔案Test.txt從 TestDir1 移至 TestDir2 ，並將其重新命名。Test2.txt

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

備註

如果目標結構不存在，則會建立它。

只有在MoveFile移動相同磁碟區內的檔案時，方法才會保留 ACE (存取控制 專案) 。 這包括繼承的 ACE，在行動 (直接 ACE 時，會優先於繼承的 ACE) 。 如果檔案在磁碟區之間移動，則不會複製 ACE。

下表列出涉及 My.Computer.FileSystem.MoveFile 方法的工作範例。

收件者	請參閱
移動檔案	作法：移動檔案

另請參閱

• 物件 (Visual Basic)
• 在 Visual Basic 中建立、刪除和移動檔案和目錄

MoveFile(String, String, UIOption, UICancelOption)

將檔案移至新的位置。

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public 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 從 TestDir1 移至 TestDir2。

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

本範例會將檔案Test.txt從 TestDir1 移至 TestDir2 ，並將其重新命名。Test2.txt

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

備註

如果目標結構不存在，則會建立它。

只有在MoveFile移動相同磁碟區內的檔案時，方法才會保留 ACE (存取控制) 。 這包括繼承的 ACE，在行動 (直接 ACE 時，會優先於繼承的 ACE) 。 如果檔案在磁碟區之間移動，則不會複製 ACE。

下表列出涉及 My.Computer.FileSystem.MoveFile 方法的工作範例。

收件者	請參閱
移動檔案	作法：移動檔案

另請參閱

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