Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TdxCloudStorageItem.CopyTo(TdxCloudStorageFolder) Method

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

#Declaration

Delphi
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.

See Also