Asynchronously moves files that match the search condition specified in the
options parameter
from the specified directory to the destination directory on this file system.
This method only moves the items of the specified directory if the
sourcePath parameter does not end with a directory separator (e.g. '/' or '\').
To move the whole directory, use the
Rename method instead.
public Task<FileSystemTransferStatistics> MoveAsync(
string sourcePath,
IEnumerable itemsToMove,
string destinationPath,
TransferOptions options,
ExtendedAsyncCompletedEventHandler<FileSystemTransferStatistics> callback,
object userState = null
)
Public Function MoveAsync( _
ByVal sourcePath As String, _
ByVal itemsToMove As IEnumerable, _
ByVal destinationPath As String, _
ByVal options As TransferOptions, _
ByVal callback As ExtendedAsyncCompletedEventHandler(Of FileSystemTransferStatistics), _
ByVal userState As Object = null _
) As Task(Of FileSystemTransferStatistics)
public:
Task<FileSystemTransferStatistics> MoveAsync(
String^ sourcePath,
IEnumerable^ itemsToMove,
String^ destinationPath,
TransferOptions^ options,
ExtendedAsyncCompletedEventHandler<FileSystemTransferStatistics>^ callback,
Object^ userState = null
);
Parameters
- sourcePath
- The path of the directory containing files and subdirectories to move.
When the parameter itemsToMove is a null reference, this can contain wildcard masks.
For example, "/myremotedir/*.dat;*.cs,*.vb" means all .dat, .cs, and .vb files in '/myremotedir' will be moved, "/myremotedir" means all files in '/myremotedir' will be moved.
For more details, see NameSearchCondition and the option SearchConditionCombinedWithMasksInSourcePath.
- itemsToMove
- The list of files and directories to move, or a null reference to transfer files in the sourcePath that match the search condition specified in the options parameter.
This list must comprise file paths in String and/or FileInfoBase instances. (e.g.
string[] files = new string[] {"file1", "file2", "dir1" }
or object[] files = new string[] {"file1", fileInfo1, fileInfo2 }
)
If this value ends with a directory separator character like '/' or '\', the containing directory will also be moved. For example, if "/folder/" is used, files and subdirectories of "folder" directory and itself will be moved; the destination directory will contain "folder" directory and its contents. - destinationPath
- The path of the destination directory.
- options
- The transfer options object which provides many settings to control the file transfer process.
- callback
- An optional asynchronous callback to be invoked when this operation completes. This parameter can be null.
- userState
- A user-provided object that identifies this particular asynchronous operation.
Return Value
An object that references the asynchronous operation.