共用方式為


FileSystem.MoveFile 方法

定義

將檔案移至新的位置。

多載

MoveFile(String, String)

將檔案移至新的位置。

MoveFile(String, String, UIOption)

將檔案移至新的位置。

MoveFile(String, String, Boolean)

將檔案移至新的位置。

MoveFile(String, String, UIOption, UICancelOption)

將檔案移至新的位置。

MoveFile(String, String)

來源:
FileSystem.vb
來源:
FileSystem.vb
來源:
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

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

例外狀況

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

destinationFileNameNothing 或空字串。

來源檔案無效或不存在。

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

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

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

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

範例

本範例會將檔案 Test.txtTestDir1TestDir2移至 。

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

本範例會將檔案 Test.txtTestDir1TestDir2 移至 ,並將其重新命名為 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
來源:
FileSystem.vb
來源:
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

例外狀況

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

destinationFileNameNothing 或空字串。

來源檔案無效或不存在。

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

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

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

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

範例

本範例會將檔案 Test.txtTestDir1TestDir2移至 。

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

本範例會將檔案 Test.txtTestDir1TestDir2 移至 ,並將其重新命名為 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)

來源:
FileSystem.vb
來源:
FileSystem.vb
來源:
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

例外狀況

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

destinationFileNameNothing 或空字串。

來源檔案無效或不存在。

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

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

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

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

範例

本範例會將檔案 Test.txtTestDir1TestDir2移至 。

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

本範例會將檔案 Test.txtTestDir1TestDir2 移至 ,並將其重新命名為 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
來源:
FileSystem.vb
來源:
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

例外狀況

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

destinationFileNameNothing 或空字串。

來源檔案無效或不存在。

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

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

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

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

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

範例

本範例會將檔案 Test.txtTestDir1TestDir2移至 。

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

本範例會將檔案 Test.txtTestDir1TestDir2 移至 ,並將其重新命名為 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 中移動檔案

另請參閱

適用於