CopyResource Method

Copies the file or folder specified by ResourcePath to a new location.

Syntax

dropbox.copyResource(toPath, [callback])

Callback

The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).

The callback for this method is defined as:

function(err){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'err' has 2 properties which hold detailed information:

err.code
err.message

Remarks

This method copies the file or folder specified by ResourcePath to the destination specified by the ToPath parameter.

The ToPath parameter must be the absolute path to the new location. In the case of files this must include the filename.

When copying a folder the entire folder contents will be copied. The destination folder must not exist prior to copying.

Example:

//Copy a File
dropbox.ResourcePath = "/Old Folder/file.txt";
dropbox.CopyResource("/New Folder/file.txt");

//Copy a Folder
dropbox.ResourcePath = "/Old Folder";
dropbox.CopyResource("/New Folder 2"); //NOTE: "New Folder 2" must not already exist