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