MoveRecord Method
Moves a file, or a directory and its contents, to another location.
Syntax
MoveRecord (Source, Destination, UserName, Password, Options, Async)
Parameters
Source Optional. A String value that contains a URL identifying the Record to be moved. If Source is omitted or specifies an empty string, the file or directory represented by this Record is moved.
Destination Optional. A String value that contains a URL specifying the location where Source will be moved.
UserName 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. A Boolean value that, when True, specifies this operation should be asynchronous.
Return Value
A String value. Typically, the value of Destination is returned. However, the exact value returned is provider-dependent.
Remarks
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.
This method updates all hypertext links in files being moved unless otherwise specified by Options. This method fails if Destination identifies an existing file or directory, unless adMoveOverWrite is specified.
Note 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. 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.