StorageFile.MoveAsync(IStorageFolder, String, NameCollisionOption) | moveAsync(IStorageFolder, String, NameCollisionOption) method

Applies to Windows and Windows Phone

Moves the current file to the specified folder and renames the file according to the desired name. This method also specifies what to do if a file with the same name already exists in the specified folder.

Syntax


public IAsyncAction MoveAsync(
  IStorageFolder destinationFolder, 
  string desiredNewName, 
  NameCollisionOption option
)

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: String [JavaScript] | 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, the specified NameCollisionOption determines how Windows responds to the conflict.

option

Type: NameCollisionOption

An enum value that determines how Windows responds if the desiredNewName is the same as the name of an existing file in the destination folder.

Return value

Type: IAsyncAction

No object or value is returned by this method.

Requirements

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

StorageFile
MoveAsync(IStorageFolder)
MoveAsync(IStorageFolder, String)

 

 

Show:
© 2014 Microsoft