TdxCloudStorageItem.CopyTo(TdxCloudStorageFolder) Method

Copies the online resource to the specified folder within the same cloud file storage.

Declaration

procedure CopyTo(AParent: TdxCloudStorageFolder); virtual;

Parameters

Name	Type
AParent	TdxCloudStorageFolder

Remarks

Call this procedure to copy the current file or folder to a cloud folder whose metadata container is passed as the AParent parameter. If the current online resource is a non-empty folder, the CopyTo procedure also copies every nested file and folder at all nesting levels. The copy operation can take a noticeable amount of time depending on the total copied data size and the copied resource count.

Calling the CopyTo procedure raises an exception if the current online resource does not support the copy operation. For instance, it is impossible to copy the root and special folders. Refer to the descriptions of the CopyTo procedure implementations provided by the TdxCloudStorageItem class descendants for additional information.

Note

A single CopyTo procedure call sends only a single resource copy request to the connected cloud file storage’s server regardless of the nested resource count if the copied resource is a non-empty folder. The cloud storage component raises the OnItemCopied event once for every successful file or folder copy request. If a CopyTo call results in an error, the OnError event occurs instead.