信息
您所需的主题如下所示。但此主题未包含在此库中。

FileInfo.CopyTo 方法 (String, Boolean)

2013/12/13

将现有文件复制到新文件,允许覆盖现有文件。

Namespace:  System.IO
程序集:  mscorlib(位于 mscorlib.dll 中)

public FileInfo CopyTo(
	string destFileName,
	bool overwrite
)

参数

destFileName
类型: System.String
要复制到的新文件的名称。
overwrite
类型: System.Boolean
若为 true,则允许覆盖现有文件;否则为 false

返回值

类型: System.IO.FileInfo
新文件,或者如果 overwritetrue,则覆盖现有文件。如果文件存在,且 overwritefalse,则会引发 IOException

异常条件
ArgumentException

destFileName 为空,仅包含空白,或包含无效字符。

IOException

发生错误,或者目标文件已经存在,并且 overwritefalse

SecurityException

调用方没有所要求的权限。

ArgumentNullException

destFileNamenull

DirectoryNotFoundException

destFileName 中指定的目录不存在。

UnauthorizedAccessException

传入了一个目录路径,或者正在将文件移动到另一个驱动器。

PathTooLongException

指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260 个字符。

NotSupportedException

destFileName 的字符串中间包含一个冒号 (:)。

版本说明

Windows Phone

 此成员具有 SecurityCriticalAttribute 特性。此特性将此成员限制为内部使用。使用此成员的应用程序代码引发 MethodAccessException

Windows Phone OS

受以下版本支持: 8.0, 7.1, 7.0

Windows Phone

显示: