FileSystemProxy.CopyFile 方法

定义

命名空间:

Microsoft.VisualBasic.MyServices

程序集:

Microsoft.VisualBasic.Forms.dll

将文件复制到新的位置。

重载

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

文件应复制到的位置。

例外

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

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

另请参阅

• UICancelOption
• 对象 (Visual Basic)
• 如何：在 Visual Basic 中将具有特定模式的文件复制到目录中
• 如何：在同一目录中创建文件副本 (Visual Basic)
• 如何：在 Visual Basic 中将一个目录复制到另一个目录
• 如何：在 Visual Basic 中重命名文件

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。

例外

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

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

另请参阅

• UICancelOption
• 对象 (Visual Basic)
• 如何：在 Visual Basic 中将具有特定模式的文件复制到目录中
• 如何：在同一目录中创建文件副本 (Visual Basic)
• 如何：在 Visual Basic 中将一个目录复制到另一个目录
• 如何：在 Visual Basic 中重命名文件

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。

例外

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

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

另请参阅

• UICancelOption
• 对象 (Visual Basic)
• 如何：在 Visual Basic 中将具有特定模式的文件复制到目录中
• 如何：在同一目录中创建文件副本 (Visual Basic)
• 如何：在 Visual Basic 中将一个目录复制到另一个目录
• 如何：在 Visual Basic 中重命名文件

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。

例外

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

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

另请参阅

• UICancelOption
• 对象 (Visual Basic)
• 如何：在 Visual Basic 中将具有特定模式的文件复制到目录中
• 如何：在同一目录中创建文件副本 (Visual Basic)
• 如何：在 Visual Basic 中将一个目录复制到另一个目录
• 如何：在 Visual Basic 中重命名文件