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)

Source:

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 从 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 将变为直接 ACE。 如果在卷之间移动文件，则不会复制 ACE。

下表列出了涉及 My.Computer.FileSystem.MoveFile 方法的任务示例。

功能	查看
移动文件	如何：在 Visual Basic 中移动文件

MoveFile(String, String, UIOption)

Source:

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 从 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 将变为直接 ACE。 如果在卷之间移动文件，则不会复制 ACE。

下表列出了涉及 My.Computer.FileSystem.MoveFile 方法的任务示例。

功能	查看
移动文件	如何：在 Visual Basic 中移动文件

另请参阅

• UIOption

MoveFile(String, String, Boolean)

Source:

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 从 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 将变为直接 ACE。 如果在卷之间移动文件，则不会复制 ACE。

下表列出了涉及 My.Computer.FileSystem.MoveFile 方法的任务示例。

功能	查看
移动文件	如何：在 Visual Basic 中移动文件

MoveFile(String, String, UIOption, UICancelOption)

Source:

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 从 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 将变为直接 ACE。 如果在卷之间移动文件，则不会复制 ACE。

下表列出了涉及 My.Computer.FileSystem.MoveFile 方法的任务示例。

功能	查看
移动文件	如何：在 Visual Basic 中移动文件

另请参阅

• UIOption
• UICancelOption