CopyFolder 方法

JScript


CopyFolder 方法

将文件夹连同子文件夹从一个位置复制到另一个位置。

object.CopyFolder ( source, destination[, overwrite] );

参数

object

必选项。 应为 FileSystemObject 的名称。

source

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

destination

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

overwrite

可选项。 Boolean 值,指明是否覆盖已有文件夹。 如果为 true ,则文件将被覆盖;如果为 false ,则文件不会被覆盖。 默认的是 true

说明

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

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

但不能使用:

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

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

  • 如果 destination 不存在,将会复制 source 文件夹及其所有子文件夹。 这是通常情况。
  • 如果 destination 是已有的文件夹,将产生一个错误。
  • 如果 destination 是一个目录,那么将试图复制文件夹及其所有内容。 如果 source 中包含的一个文件在 destination 已经有了,那么当 overwritefalse 时将会出错。 否则会试图用该文件覆盖已有文件。
  • 如果 destination 是一个只读目录,同时 overwritefalse ,那么在试图将已有的只读文件复制到目录中时将会出错。

如果使用了通配字符的 source 不能匹配任何文件夹,那么将产生错误。

CopyFolder 方法在遇到第一个错误时终止。 出错后不试图回滚出错前所做的修改。

请参阅

CopyFile 方法 | Copy 方法 | CreateFolder 方法 | DeleteFolder 方法 | MoveFolder 方法应用于: FileSystemObject 对象