Метод CopyRecord (ADO)

  • Статья

Копирует сущность, представленную записью , в другое расположение.

Синтаксис

  
Record.CopyRecord (Source, Destination, UserName, Password, Options, Async)

Параметры

Источник
Необязательный элемент. Строковое значение, содержащее URL-адрес, указывающий копируемый объект (например, файл или каталог). Если параметр Source не указан или указывает пустую строку, будет скопирован файл или каталог, представленный текущей записью .

Назначение
Необязательный элемент. Строковое значение, содержащее URL-адрес, указывающий расположение, в которое будет скопирован источник.

UserName
Необязательный элемент. Строковое значение, содержащее идентификатор пользователя, который при необходимости разрешает доступ к назначению.

Пароль
Необязательный элемент. Строковое значение, содержащее пароль, который при необходимости проверяет UserName.

Параметры
Необязательный элемент. Значение CopyRecordOptionsEnum со значением по умолчанию adCopyUnspecified. Задает поведение этого метода.

Асинхронный режим
Необязательный элемент. Логическое значение, которое при значении True указывает, что эта операция должна быть асинхронной.

Возвращаемое значение

Строковое значение, которое обычно возвращает значение Destination. Однако точное возвращаемое значение зависит от поставщика.

Комментарии

Значения Source и Destination не должны быть одинаковыми; в противном случае возникает ошибка во время выполнения. По крайней мере одно имя сервера, пути или ресурса должно отличаться.

Все дочерние (например, подкаталоги) source копируются рекурсивно, если не указан параметр adCopyNonRecursive . В рекурсивной операции назначение не должно быть подкаталогом Source; В противном случае операция не будет завершена.

Этот метод завершается ошибкой, если destination определяет существующую сущность (например, файл или каталог), если не указан параметр adCopyOverWrite .

Важно!

Используйте параметр adCopyOverWrite разумно. Например, если указать этот параметр при копировании файла в каталог, каталог будет удален и заменен файлом.

Примечание

URL-адреса, использующие схему HTTP, автоматически вызывают поставщика Microsoft OLE DB для публикации в Интернете. Дополнительные сведения см. в разделе Абсолютные и относительные URL-адреса.

Применение

Объект Record (ADO)