ADO: ActiveX Data Objects

Name

Record.MoveRecord Method — (Versions 2.5, 2.6)

Synopsis

record.MoveRecord  (Source, _
                    Destination, _
                    UserName, _
                    Password, _
                    Options, _
                    Async) As String

The MoveRecord method moves a resource to another location.

Arguments

Source (String)

Optional. Indicates the URL of a resource to be moved. If this argument is omitted, then the resource represented by the current Record object is moved.

Destination (String)

Optional. Represents a URL value that indicates where the resource will be moved.

UserName (String)

Optional. Indicates, if necessary, the username that will be used to access the resource indicated by the Destination argument.

Password (String)

Optional. Indicates, if necessary, the password to verify the UserName argument.

Options (CopyRecordOptionsEnum)

Optional. Indicates the behavior of the move operation. The default value for this argument is adMoveUnspecified.

Async (Boolean)

Optional. Indicates whether this operation should be executed asynchronously.

Returns

String

Description

By default, the MoveRecord method does not overwrite a resource that already exists. To force the replacement of the destination resource, use the adCopyOverWrite option. All hypertext links in the file are automatically updated unless otherwise specified in the Options argument.

If the source and the destination resources are identical, an error will occur.

If the Record object was created from a Recordset object, you should close and reopen the Recordset object or call Resync or Requery for the resource ...