StorageFile.CopyAsync(IStorageFolder, String) | copyAsync(IStorageFolder, String) method

Applies to Windows and Windows Phone

Creates a copy of the file in the specified folder, using the desired name.

Syntax


public:
IAsyncOperation<StorageFile>^ CopyAsync(
  IStorageFolder^ destinationFolder, 
  String^ desiredNewName
)

Parameters

destinationFolder

Type: IStorageFolder

The destination folder where the copy is created.

desiredNewName

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

The desired name of the copy.

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

Return value

Type: IAsyncOperation<StorageFile>

When this method completes, it returns a StorageFile that represents the copy.

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
CopyAsync(IStorageFolder)
CopyAsync(IStorageFolder, String, NameCollisionOption)

 

 

Show:
© 2014 Microsoft