JSCRIPT MANUAL

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

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


Описание
Копирует один или более файлов из одного места в другое.
Синтаксис
object.CopyFile ( source, destination[, overwrite] )

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

Часть Описание
object Требуется. Параметр object всегда является именем объекта FileSystemObject.
source Требуется. Строковое выражение, указывающее путь (возможно включающий символы подстановки), откуда будут скопированы файлы.
destination Требуется. Строковое выражение, указывающее, куда будут скопированы файлы из source. Символы подстановки недопустимы.
overwrite Необязательно. Логическое значение, указывающее, должны ли существующие файлы быть перезаписаны. Если значение равно true, файлы перезаписываются; если false, то не перезаписываются. Значение по умолчанию равно true. Обратите внимание,что применение метода CopyFile вызовет сбой, если для destination установлен аттрибут только для чтения независимо от значения overwrite.

Примечание
Символы подстановки могут применяться лишь в последнем компоненте пути параметра 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 - существующий файл, возникает ошибка при overwrite равном false. Иначе делается попытка скопировать source поверх существующего файла.
  • Если destination является директорией, то возникает ошибка.
Также возникает ошибка, если в source применены символы подстановки, несоответствующие ни одному файлу. Метод CopyFile останавливается при встрече с первой ошибкой. Никаких попыток для отмены сделанных изменений до возникновения ошибки не производится.


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