JSCRIPT MANUAL

Microsoft® JScript™
Метод CopyFolder
 Справочник языка 
 Версия 3 

См. также                  Применение


Описание
Рекурсивно копирует папку из одного места в другое.
Синтаксис
object.CopyFolder ( source, destination[, overwrite] );

Синтаксис метода CopyFolder состоит из частей:

Часть Описание
object Требуется. Всегда является именем объекта FileSystemObject.
source Требуется. Строковое значение, обозначающее путь, откуда одна или несколько папок будут скопированы. Может содержать символы подстановки.
destination Требуется. Строковое значение, обозначающее путь, куда папки и подкаталоги будут копироваться из source. Символы подстановки не допускаются.
overwrite Необязательно. Логическое значение, указывающее, должны ли существующие папки быть перезаписаны. При значении 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 останавливается после первой встреченной ошибки. Никаких попыток для восстановления уже сделанных до ошибки изменений не производится.



Перевод © 2000-2013 pauk R-T-F-M.info. Все права защищены.