CopyFile 方法

JScript


CopyFile 方法

从一个位置向另一个位置复制一个或多个文件。

object.CopyFile ( source, destination[, overwrite] )

参数

object

必选项。 object 应为 FileSystemObject的名称。

source

必选项。 指定文件字符串,可以包含通配字符来复制一个或多个文件。

destination

必选项。 目的字符串,文件将从 source 复制到这里。 不允许通配字符。

overwrite

可选项。 Boolean 值,指明是否覆盖已有文件。 如果为 true ,则文件将被覆盖;如果为 false ,则文件不会被覆盖。 默认的是 true 。 注意,如果 destination 设置了只读属性,那么无论 overwrite 的值是什么, CopyFile 都会失败。

说明

通配字符只能用在 source 参数中最后的路径成分中。 举例来说,可以使用:

fso = new ActiveXObject("Scripting.FileSystemObject");
fso.CopyFile ("c:\\mydocuments\\letters\\*.doc", "c:\\tempfolder\\")

但不能够使用:

fso = new ActiveXObject("Scripting.FileSystemObject");
fso.CopyFile ("c:\\mydocuments\\*\\R1???97.xls", "c:\\tempfolder")

如果 source 包含了通配字符或者 destination 以路径分隔符 (\) 结束,那么将假定 destination 是一个已有的文件夹,满足匹配的文件将复制到这个文件夹中。 否则,将假定 destination 是要创建的文件名。 无论哪种情况,如果复制的是单个文件,将会有三种可能。

  • 如果 destination 不存在,那么 source 将被复制。 这是通常情况。
  • 如果 destination 是已有文件,当 overwritefalse 时将会产生一个错误。 否则将会试图用 source 覆盖已有文件。
  • 如果 destination 是目录,将会出错。

如果使用通配字符的 source 不能匹配任何文件,将会出错。 CopyFile 方法遇到第一个错误时终止。 出错后不会试图回滚或撤消出错前所做的修改。

请参阅

Copy 方法 | CopyFolder 方法 | CreateTextFile 方法 | DeleteFile 方法 | MoveFile 方法应用于: FileSystemObject 对象