Skip to main content
FileInformation.MoveAsync(IStorageFolder, String, NameCollisionOption) | moveAsync(IStorageFolder, String, NameCollisionOption) method

Moves the StorageFile to the specified folder and gives it the specified file name. The method also specifies what to do if a file with the same name already exists in the specified folder.

Syntax


fileInformation.moveAsync(destinationFolder, desiredNewName, option).done( /* Your success and error handlers */ );

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

Public Function MoveAsync(
  destinationFolder As IStorageFolder,  
  desiredNewName As String,  
  option As NameCollisionOption 
) As IAsyncAction

public:
IAsyncAction^ MoveAsync(
  IStorageFolder^ destinationFolder, 
  String^ desiredNewName, 
  NameCollisionOption option
)

Parameters

destinationFolder

Type: IStorageFolder

The destination folder.

desiredNewName

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

The new file name.

option

Type: NameCollisionOption

A value that indicates what to do if the file name already exists in the destination folder.

Return value

Type: IAsyncAction

No object or value is returned when this method completes.

Requirements ( device family)

Device family

Desktop

API contract

Windows.Storage.BulkAccess.BulkAccessContract, introduced version 1.0

Namespace

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

Metadata

Windows.Storage.BulkAccess.BulkAccessContract.winmd

Requirements (operating system)

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

None supported

Namespace

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

Metadata

Windows.winmd

See also

FileInformation
MoveAsync(IStorageFolder)
MoveAsync(IStorageFolder, String)