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