Windows Dev Center

IStorageFile.MoveAsync(IStorageFolder, String) method

Moves the current file to the specified folder and renames the file according to the desired name.

Syntax


IAsyncAction MoveAsync(
  IStorageFolder destinationFolder, 
  string desiredNewName
)

Parameters

destinationFolder

Type: IStorageFolder

The destination folder where the file is moved.

This destination folder must be a physical location. Otherwise, if the destination folder exists only in memory, like a file group, this method fails and throws an exception.

desiredNewName

Type: System.String [.NET] | Platform::String [C++]

The desired name of the file after it is moved.

If there is an existing file in the destination folder that already has the specified desiredNewName, Windows generates a unique name for the file.

Return value

Type: IAsyncAction

No object or value is returned by this method.

Remarks

If you simply want to move a file in your app, see the MoveAsync methods of the StorageFile class.

Requirements (Windows 10 device family)

Device family

Universal

API contract

Windows.Foundation.UniversalApiContract, introduced version 1.0

Namespace

Windows.Storage
Windows::Storage [C++]

Metadata

Windows.Foundation.UniversalApiContract.winmd

Requirements (Windows 8.x and Windows Phone 8.x)

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8

Namespace

Windows.Storage
Windows::Storage [C++]

Metadata

Windows.winmd

See also

IStorageFile
MoveAsync(IStorageFolder)
MoveAsync(IStorageFolder, String, NameCollisionOption)
StorageFile.MoveAsync

 

 

Show:
© 2015 Microsoft