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 已经有了，那么当 overwrite 为 false 时将会出错。 否则会试图用该文件覆盖已有文件。
• 如果 destination 是一个只读目录，同时 overwrite 为 false ，那么在试图将已有的只读文件复制到目录中时将会出错。

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

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

请参阅

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