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.MoveToTrash Method

In This Article

Moves the online resource to the “Trash” special folder.

#Declaration

Delphi
procedure MoveToTrash; virtual;

#Remarks

Call this procedure to move the file or folder corresponding to the current metadata container to the “Trash” special folder. If the current online resource is a non-empty folder, the MoveToTrash procedure also trashes every nested file and folder at all nesting levels. The trash operation can take a noticeable amount of time depending on the total resource count. If the resource is already within the “Trash” folder (that is, the Trashed property returns True), a MoveToTrash procedure call produces no effect.

A MoveToTrash procedure call raises an exception if the current online resource does not support this operation. For instance, you cannot place a special or root folder in the “Trash” folder. Refer to the descriptions of the MoveToTrash procedure implementations of TdxCloudStorageItem class descendants for additional information.

Note

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

See Also