ADO CopyRecord and MoveRecord Methods
❮ Complete Record Object Reference
CopyRecord
The CopyRecord method copies a file or directory to another location.
MoveRecord
The MoveRecord method moves a file or directory to another location.
Note: The ParentURL property will not be automatically updated. You must close the Record and then open it again with the new URL.
Syntax
CopyRecord(src,dest,username,psword,opt,async)
MoveRecord(src,dest,username,psword,opt,async)
Parameter | Description |
---|---|
src | Optional. The URL of the file or directory that will be copied/moved |
dest | Optional. The URL to the location where src will be copied/moved |
username | Optional. The user ID that authorizes access to dest |
psword | Optional. The password that verifies username |
opt | For CopyRecord: Optional. A CopyRecordOptionsEnum
value that
specifies the behavior of this method. Default is adCopyUnspecified
For MoveRecord: Optional. A MoveRecordOptionsEnum value that specifies the behavior of this method. Default is adMoveUnspecified |
async | Optional. A Boolean value that, when True, sets this operation to be asynchronous |
CopyRecordOptionsEnum Values
Constant | Value | Description |
---|---|---|
adCopyUnspecified | -1 | Default. Will not allow over write or recursive copy |
adCopyOverWrite | 1 | Overwrites the file/directory if it already exists |
adCopyNonRecursive | 2 | Copies the current directory (none of its subdirectories) to the destination (this operation is not recursive) |
adCopyAllowEmulation | 4 | Requests that the provider attempt to simulate the copy. If the attempt to copy the Record fails because the destination URL is on a different server or serviced by a different provider than the source, this may cause data loss |
MoveRecordOptionsEnum Values
Constant | Value | Description |
---|---|---|
adMoveUnspecified | -1 | Default. Will not overwrite any file/ directory at the destination location. Will also update links |
adMoveOverWrite | 1 | Overwrites the file/directory if it already exists |
adMoveDontUpdateLinks | 2 | Modifies the default behavior of MoveRecord method by not updating the links of the source Record. The default behavior depends on the capabilities of the provider |
adMoveAllowEmulation | 4 | Requests that the provider attempt to simulate the move. If the attempt to move the Record fails because the destination URL is on a different server or serviced by a different provider than the source, this may cause data loss |
❮ Complete Record Object Reference