Метод MoveRecord (ADO)

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

Синтаксис

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

Параметры

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

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

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

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

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

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

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

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

Замечания

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

Для файлов, перемещаемых с помощью поставщика публикации в Интернете, этот метод обновляет все ссылки гипертекста в файлах, перемещаемых, если иное не указано в параметрах . Этот метод завершается ошибкой, если назначения определяет существующий объект (например, файл или каталог), если adMoveOverWrite.

Заметка

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

Некоторые атрибуты объекта записи, например свойство ParentURL, не будут обновляться после завершения этой операции. Обновите свойства объекта Record, закрыв записи, а затем повторно откройте его с URL-адресом расположения, в котором был перемещен файл или каталог.

Если этот запись получен из набора записей , новое расположение перемещаемого файла или каталога не будет отражено немедленно в наборе записей. Обновите набора записей, закрыв и повторно открыв его.

Заметка

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

Применимо к

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

См. также

метод перемещения (ADO)
MoveFirst, MoveLast, MoveNext и MovePrevious Methods (ADO)
MoveFirst, MoveLast, MoveNext и MovePrevious Methods (RDS)