Метод MoveRecord (ADO)MoveRecord Method (ADO)

Перемещает сущность, представленную записью , в другое место.Moves the entity represented by a Record to another location.

СинтаксисSyntax

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

ПараметрыParameters

SourceSource
Необязательный элемент.Optional. Строковое значение, содержащее URL-адрес, указывающий перемещаемую запись .A String value that contains a URL identifying the Record to be moved. Если Source не указан или указывает пустую строку, перемещается объект, представленный этой записью .If Source is omitted or specifies an empty string, the object represented by this Record is moved. Например, если запись представляет файл, содержимое файла перемещается в расположение, указанное в поле назначение.For example, if the Record represents a file, the contents of the file are moved to the location specified by Destination.

НазначениеDestination
Необязательный элемент.Optional. Строковое значение, содержащее URL-адрес, указывающий расположение, куда будет перемещен источник .A String value that contains a URL specifying the location where Source will be moved.

UserNameUserName
Необязательный элемент.Optional. Строковое значение, содержащее идентификатор пользователя, который при необходимости авторизует доступ к назначению.A String value that contains the user ID that, if needed, authorizes access to Destination.

ПарольPassword
Необязательный элемент.Optional. Строка , содержащая пароль, который при необходимости проверяет имя пользователя.A String that contains the password that, if needed, verifies UserName.

ПараметрыOptions
Необязательный элемент.Optional. Значение моверекордоптионсенум , значение по умолчанию — адмовеунспеЦифиед.A MoveRecordOptionsEnum value whose default value is adMoveUnspecified. Задает поведение этого метода.Specifies the behavior of this method.

Асинхронный режимAsync
Необязательный элемент.Optional. Логическое значение, которое при значении trueуказывает, что эта операция должна быть асинхронной.A Boolean value that, when True, specifies this operation should be asynchronous.

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

Строковое значение.A String value. Как правило, возвращается значение Destination .Typically, the value of Destination is returned. Однако точное возвращаемое значение зависит от поставщика.However, the exact value returned is provider-dependent.

RemarksRemarks

Значения источника и назначения не должны совпадать. в противном случае возникает ошибка времени выполнения.The values of Source and Destination must not be identical; otherwise, a run-time error occurs. По крайней мере имена сервера, пути и ресурса должны различаться.At least the server, path, and resource names must differ.

Для файлов, перемещенных с помощью поставщика публикации в Интернете, этот метод обновляет все гиперссылки в файлах, которые будут перемещены, если иное не указано в параметрах.For files moved using the Internet Publishing Provider, this method updates all hypertext links in files being moved unless otherwise specified by Options. Этот метод завершается ошибкой, если назначение определяет существующий объект (например, файл или каталог), если не указан адмовеоверврите .This method fails if Destination identifies an existing object (for example, a file or directory), unless adMoveOverWrite is specified.

Примечание

Внимательно используйте параметр адмовеоверврите .Use the adMoveOverWrite option judiciously. Например, если указать этот параметр при перемещении файла в каталог, каталог будет удален и заменен файлом.For example, specifying this option when moving a file to a directory will delete the directory and replace it with the file.

Некоторые атрибуты объекта записи , такие как свойство парентурл , не будут обновлены после завершения этой операции.Certain attributes of the Record object, such as the ParentURL property, will not be updated after this operation completes. Обновите свойства объекта Record , закрыв запись, а затем повторно открыв ее с помощью URL-адреса расположения, в которое был перемещен файл или каталог.Refresh the Record object's properties by closing the Record, then re-opening it with the URL of the location where the file or directory was moved.

Если эта запись была получена из набора записей, новое расположение перемещенного файла или каталога не будет немедленно отражено в наборе записей.If this Record was obtained from a Recordset, the new location of the moved file or directory will not be reflected immediately in the Recordset. Обновите набор записей , закрыв и повторно открыв его.Refresh the Recordset by closing and re-opening it.

Примечание

URL-адреса, использующие схему HTTP, автоматически вызывают поставщик OLE DB Майкрософт для публикации в Интернете.URLs using the http scheme will automatically invoke the Microsoft OLE DB Provider for Internet Publishing. Дополнительные сведения см. в разделе абсолютные и относительные URL-адреса.For more information, see Absolute and Relative URLs.

ПрименениеApplies To

Объект Record (ADO)Record Object (ADO)

См. такжеSee Also

Метод Move (ADO) Move Method (ADO)
Методы MoveFirst, MoveLast, MoveNext и MovePrevious (ADO) MoveFirst, MoveLast, MoveNext, and MovePrevious Methods (ADO)
Методы MoveFirst, MoveLast, MoveNext и MovePrevious (служба удаленных рабочих столов)MoveFirst, MoveLast, MoveNext, and MovePrevious Methods (RDS)