FileSystem.CopyFile 方法

参考

定义

命名空间:: Microsoft.VisualBasic.FileIO

程序集:: Microsoft.VisualBasic.Core.dll

程序集:: Microsoft.VisualBasic.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

将文件复制到新的位置。

重载

CopyFile(String, String)	将文件复制到新的位置。
CopyFile(String, String, UIOption)	将文件复制到新的位置。
CopyFile(String, String, Boolean)	将文件复制到新的位置。
CopyFile(String, String, UIOption, UICancelOption)	将文件复制到新的位置。

CopyFile(String, String)

Source:: FileSystem.vb

Source:: FileSystem.vb

Source:: FileSystem.vb

将文件复制到新的位置。

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

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

static member CopyFile : string * string -> unit

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

参数

sourceFileName: String

要复制的文件。

destinationFileName: String

文件应复制到的位置。

例外

ArgumentException

destinationFileName 包含路径信息。

ArgumentNullException

destinationFileName 或 sourceFileName 为 Nothing 或空字符串。

FileNotFoundException

源文件无效或不存在。

IOException

目标目录中的同名文件正被使用。

NotSupportedException

路径中的文件名或目录名包含冒号 (:)，或格式无效。

PathTooLongException

路径超过了系统定义的最大长度。

UnauthorizedAccessException

该用户没有必需的权限。

SecurityException

该用户缺少查看该路径所必需的权限。

示例

此示例在不覆盖现有文件的情况下将文件 Test.txt 复制到目录 TestFiles2 。

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

将文件路径替换为要在代码中使用的路径。

此示例将文件 Test.txt 复制到目录 TestFiles2 ，并将其重命名 NewFile.txt为。

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

将文件路径替换为要在代码中使用的路径。

注解

CopyFile不保留 ACE (访问控制条目) 。新创建的文件从创建它的目录继承默认 ACE。

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

功能	查看
将文件复制到同一目录。	如何：在同一目录中创建文件副本 (Visual Basic)
将文件复制到其他目录。	如何：在 Visual Basic 中在不同的目录中创建文件的副本

另请参阅

UICancelOption

适用于

.NET 9 和其他版本

产品	版本
.NET	Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

CopyFile(String, String, UIOption)

Source:: FileSystem.vb

Source:: FileSystem.vb

Source:: FileSystem.vb

将文件复制到新的位置。

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

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

static member CopyFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit

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

参数

sourceFileName: String

要复制的文件。

destinationFileName: String

文件应复制到的位置。

showUI: UIOption

是否对操作进度进行可视跟踪。默认值为 UIOption.OnlyErrorDialogs。

例外

ArgumentException

destinationFileName 包含路径信息。

ArgumentNullException

destinationFileName 或 sourceFileName 为 Nothing 或空字符串。

FileNotFoundException

源文件无效或不存在。

IOException

目标文件存在，并且 overwrite 设置为 False。

NotSupportedException

路径中的文件名或目录名包含冒号 (:)，或格式无效。

PathTooLongException

路径超过了系统定义的最大长度。

UnauthorizedAccessException

该用户没有必需的权限。

SecurityException

该用户缺少查看该路径所必需的权限。

示例

此示例在不覆盖现有文件的情况下将文件 Test.txt 复制到目录 TestFiles2 。

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

将文件路径替换为要在代码中使用的路径。

此示例将文件 Test.txt 复制到目录 TestFiles2 ，并将其重命名 NewFile.txt为。

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

将文件路径替换为要在代码中使用的路径。

注解

CopyFile不保留 ACE (访问控制条目) 。新创建的文件从创建它的目录继承默认 ACE。

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

功能	查看
将文件复制到同一目录。	如何：在同一目录中创建文件副本 (Visual Basic)
将文件复制到其他目录。	如何：在 Visual Basic 中在不同的目录中创建文件的副本

另请参阅

UICancelOption

适用于

.NET 9 和其他版本

产品	版本
.NET	Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

CopyFile(String, String, Boolean)

Source:: FileSystem.vb

Source:: FileSystem.vb

Source:: FileSystem.vb

将文件复制到新的位置。

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

public static void CopyFile (string sourceFileName, string destinationFileName, bool overwrite);

static member CopyFile : string * string * bool -> unit

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

参数

sourceFileName: String

要复制的文件。

destinationFileName: String

文件应复制到的位置。

overwrite: Boolean

如果应覆盖现有文件，则为 True；否则为 False。默认值为 False。

例外

ArgumentException

destinationFileName 包含路径信息。

ArgumentNullException

destinationFileName 或 sourceFileName 为 Nothing 或空字符串。

FileNotFoundException

源文件无效或不存在。

IOException

目标文件存在，并且 overwrite 设置为 False。

NotSupportedException

路径中的文件名或目录名包含冒号 (:)，或格式无效。

PathTooLongException

路径超过了系统定义的最大长度。

UnauthorizedAccessException

该用户没有必需的权限。

SecurityException

该用户缺少查看该路径所必需的权限。

示例

此示例在不覆盖现有文件的情况下将文件 Test.txt 复制到目录 TestFiles2 。

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

将文件路径替换为要在代码中使用的路径。

此示例将文件 Test.txt 复制到目录 TestFiles2 ，并将其重命名 NewFile.txt为。

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

将文件路径替换为要在代码中使用的路径。

注解

CopyFile不保留 ACE (访问控制条目) 。新创建的文件从创建它的目录继承默认 ACE。

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

功能	查看
将文件复制到同一目录。	如何：在同一目录中创建文件副本 (Visual Basic)
将文件复制到其他目录。	如何：在 Visual Basic 中在不同的目录中创建文件的副本

另请参阅

UICancelOption

适用于

.NET 9 和其他版本

产品	版本
.NET	Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

CopyFile(String, String, UIOption, UICancelOption)

Source:: FileSystem.vb

Source:: FileSystem.vb

Source:: FileSystem.vb

将文件复制到新的位置。

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

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

static member CopyFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Shared Sub CopyFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)

参数

sourceFileName: String

要复制的文件。

destinationFileName: String

文件应复制到的位置。

showUI: UIOption

是否对操作进度进行可视跟踪。默认值为 UIOption.OnlyErrorDialogs。

onUserCancel: UICancelOption

指定当用户在操作过程中单击“取消”时应执行的操作。默认值为 ThrowException。

例外

ArgumentException

destinationFileName 包含路径信息。

ArgumentNullException

destinationFileName 或 sourceFileName 为 Nothing 或空字符串。

FileNotFoundException

源文件无效或不存在。

IOException

目标文件存在，并且 overwrite 设置为 False。

NotSupportedException

路径中的文件名或目录名包含冒号 (:)，或格式无效。

PathTooLongException

路径超过了系统定义的最大长度。

UnauthorizedAccessException

该用户没有必需的权限。

SecurityException

该用户缺少查看该路径所必需的权限。

OperationCanceledException

UICancelOption 设置为 ThrowException，并且用户已经取消了该操作或者发生了未指定的 I/O 错误。

示例

此示例在不覆盖现有文件的情况下将文件 Test.txt 复制到目录 TestFiles2 。

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

将文件路径替换为要在代码中使用的路径。

此示例将文件 Test.txt 复制到目录 TestFiles2 ，并将其重命名 NewFile.txt为。

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

将文件路径替换为要在代码中使用的路径。

注解

CopyFile不保留 ACE (访问控制条目) 。新创建的文件从创建它的目录继承默认 ACE。

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

功能	查看
将文件复制到同一目录。	如何：在同一目录中创建文件副本 (Visual Basic)
将文件复制到其他目录。	如何：在 Visual Basic 中在不同的目录中创建文件的副本

另请参阅

UICancelOption

适用于

.NET 9 和其他版本

产品	版本
.NET	Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

通过

FileSystem.CopyFile 方法

定义

重载

CopyFile(String, String)

参数

例外

示例

注解

另请参阅

适用于

CopyFile(String, String, UIOption)

参数

例外

示例

注解

另请参阅

适用于

CopyFile(String, String, Boolean)

参数

例外

示例

注解

另请参阅

适用于

CopyFile(String, String, UIOption, UICancelOption)

参数

例外

示例

注解

另请参阅

适用于

其他资源