FileSystemProxy.CopyFile 方法

定义

将文件复制到新的位置。

重载

CopyFile(String, String)

将文件复制到新的位置。

CopyFile(String, String, UIOption)

将文件复制到新的位置。

CopyFile(String, String, Boolean)

将文件复制到新的位置。

CopyFile(String, String, UIOption, UICancelOption)

将文件复制到新的位置。

CopyFile(String, String)

将文件复制到新的位置。

public:
 void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName);
public void CopyFile (string sourceFileName, string destinationFileName);
member this.CopyFile : string * string -> unit
Public Sub CopyFile (sourceFileName As String, destinationFileName As String)

参数

sourceFileName
String

要复制的文件。

destinationFileName
String

文件应复制到的位置。

例外

destinationFileName 包含路径信息。

destinationFileNamesourceFileNameNothing 或空字符串。

源文件无效或不存在。

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

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

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

该用户没有必需的权限。

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

示例

此示例在不覆盖现有文件的情况下将文件 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 方法的任务示例。

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

另请参阅

适用于

CopyFile(String, String, UIOption)

将文件复制到新的位置。

public:
 void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);
public void CopyFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);
member this.CopyFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit
Public Sub CopyFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)

参数

sourceFileName
String

要复制的文件。

destinationFileName
String

文件应复制到的位置。

showUI
UIOption

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

例外

destinationFileName 包含路径信息。

destinationFileNamesourceFileNameNothing 或空字符串。

源文件无效或不存在。

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

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

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

该用户没有必需的权限。

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

示例

此示例在不覆盖现有文件的情况下将文件 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 方法的任务示例。

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

另请参阅

适用于

CopyFile(String, String, Boolean)

将文件复制到新的位置。

public:
 void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);
public void CopyFile (string sourceFileName, string destinationFileName, bool overwrite);
member this.CopyFile : string * string * bool -> unit
Public Sub CopyFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)

参数

sourceFileName
String

要复制的文件。

destinationFileName
String

文件应复制到的位置。

overwrite
Boolean

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

例外

destinationFileName 包含路径信息。

destinationFileNamesourceFileNameNothing 或空字符串。

源文件无效或不存在。

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

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

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

该用户没有必需的权限。

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

示例

此示例在不覆盖现有文件的情况下将文件 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 方法的任务示例。

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

另请参阅

适用于

CopyFile(String, String, UIOption, UICancelOption)

将文件复制到新的位置。

public:
 void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public void CopyFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
member this.CopyFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public 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

例外

destinationFileName 包含路径信息。

destinationFileNamesourceFileNameNothing 或空字符串。

源文件无效或不存在。

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

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

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

该用户没有必需的权限。

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

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 方法的任务示例。

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

另请参阅

适用于