TdxCloudStorageItem.MoveTo(TdxCloudStorageFolder) Method

Moves the online resource to the specified folder.

Declaration

procedure MoveTo(AParent: TdxCloudStorageFolder); virtual;

Parameters

Name	Type
AParent	TdxCloudStorageFolder

Remarks

Call this procedure to move 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 MoveTo procedure also moves every nested file and folder at all nesting levels. The move operation can take a noticeable amount of time depending on the moved resource count.

Calling the MoveTo procedure raises an exception if the current online resource does not support move operations. For instance, it is impossible to move special folders or the cloud storage root. Refer to the descriptions of the MoveTo procedure implementations provided by TdxCloudStorageItem class descendants for additional information.

Note

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