Метод CopyRecord (ADO)

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

Синтаксис

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

Параметры

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

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

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

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

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

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

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

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

Замечания

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

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

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

Важный

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

Заметка

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

Применимо к

объекта записи (ADO)

  • Last updated on