Метод CopyFile

  • Статья

Копирует один или несколько файлов из одного расположения в другое.

Синтаксис

object. Источник CopyFile, назначение, [ перезапись ]

Синтаксис метода CopyFile содержит следующие элементы:

Part Описание
object Обязательно. Объект всегда является именем Объекта FileSystemObject.
источник Обязательно. Спецификация файла строки символов, которая может содержать подстановочные знаки (для одного или нескольких копируемых файлов).
destination Обязательно. Символьное строковое обозначение конечного расположения, в которое необходимо скопировать файл или файлы из элемента source. Использование подстановочных знаков не допускается.
Перезаписать Необязательный параметр. Логическое значение, которое указывает, требуется ли перезапись существующих файлов. Если установлено значение True, файлы будут перезаписаны; если задано значение False, перезапись не выполняется. По умолчанию используется значение True. Необходимо учитывать, что функция CopyFile не выполняется, если для элемента destination установлено свойство "только чтение", независимо от значения элемента overwrite.

Замечания

Подстановочные знаки могут использоваться только в последнем компоненте пути аргумента source. Например, можно использовать:

FileSystemObject.CopyFile "c:\mydocuments\letters\*.doc", "c:\tempfolder\"

Однако нельзя использовать:

FileSystemObject.CopyFile "c:\mydocuments\*\R1???97.xls", "c:\tempfolder"

Если источник содержит подстановочные знаки или назначение заканчивается разделителем пути (****), предполагается, что назначение — это существующая папка, в которую копируются соответствующие файлы. В противном случае элемент, destination предположительно является именем создаваемого файла. В любом случае при копировании отдельного файла могут произойти три вещи:

  • Если элемент destination не существует, выполняется копирование элемента source. Это типичный случай.

  • Если элемент destination представляет собой существующий файл, возникает ошибка, если элементу overwrite присвоено значение False. В противном случае выполняется попытка копирования элемента source в существующий файл.

  • Если destination является каталогом, происходит ошибка.

Ошибка также возникает в том случае, если элемент source, который использует подстановочные знаки, не соответствует ни одному из файлов. Выполнение метода CopyFile останавливается при обнаружении первой ошибки. До возникновения ошибки попыток отката или отмены каких-либо изменений не выполняется.

Файлы, скопированные в новый целевой путь, будут сохранять одно и то же имя файла. Чтобы переименовать скопированный файл, просто добавьте новое имя файла в путь назначения. Например, файл будет скопирован в новое расположение, а файл в новом расположении будет иметь другое имя:

FileSystemObject.CopyFile "c:\mydocuments\letters\sample.doc", "c:\tempfolder\sample_new.doc"

См. также

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.