Метод CopyRecord (ADO)
Область применения: Access 2013, Office 2013
Копирует сущность, представленную записью , в другое расположение.
Синтаксис
Запись. CopyRecord (источник, назначение, имя пользователя, пароль, параметры, асинхронная синхронизация)
Параметры
| Параметр | Описание |
|---|---|
| Source | Необязательный параметр. Строковое значение, содержащее URL-адрес, указывающий копируемые сущности (например, файл или каталог). Если параметр Source не указан или указывает пустую строку, будет скопирован файл или каталог, представленный текущей записью . |
| Destination | Необязательный параметр. Строковое значение, содержащее URL-адрес, указывающий расположение, в которое будет скопирован источник. |
| UserName | Необязательный параметр. Строковое значение, содержащее идентификатор пользователя, который при необходимости разрешает доступ к назначению. |
| Password | Необязательный параметр. Строковое значение, содержащее пароль, который при необходимости проверяет имя пользователя. |
| Параметры | Необязательный параметр. Значение CopyRecordOptionsEnum , которое имеет значение по умолчанию adCopyUnspecified. Указывает поведение этого метода. |
| Async | Необязательный параметр. Логическое значение, которое при значении True указывает, что эта операция должна быть асинхронной. |
Возвращаемое значение
Строковое значение, которое обычно возвращает значение Назначения. Однако точное возвращаемое значение зависит от поставщика.
Замечания
Значения source и Destination не должны быть одинаковыми; в противном случае возникает ошибка во время выполнения. По крайней мере одно из имен серверов, путей или ресурсов должно отличаться.
Все дочерние (например, подкаталоги) source копируются рекурсивно, если не указан параметр adCopyNonRecursive . В рекурсивной операции назначение не должно быть подкаталогом Source; В противном случае операция не будет завершена.
Этот метод завершается ошибкой, если назначение идентифицирует существующую сущность (например, файл или каталог), если не указан параметр adCopyOverWrite .
Важно!
Используйте параметр adCopyOverWrite разумно. Например, если указать этот параметр при копировании файла в каталог, каталог будет удален и заменен файлом.
Примечание.
URL-адреса, использующие схему HTTP, автоматически вызывают поставщик Microsoft OLE DB для публикации в Интернете. Дополнительные сведения см. в разделе Абсолютные и относительные URL-адреса.