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 对象