Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
MSDN Library
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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