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
|
|
|
See why there are 20,000+ Ektron integrations worldwide.
Request an INSTANT DEMO or download a FREE TRIAL today. |
|
|
|