Windows Dev Center

IStorageFile.CopyAsync(IStorageFolder, String) method

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

Syntax


IAsyncOperation<StorageFile> CopyAsync(
  IStorageFolder destinationFolder, 
  string desiredNewName
)

Parameters

destinationFolder

Type: IStorageFolder

The destination folder where the copy is created.

desiredNewName

Type: 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.

Remarks

If you simply want to copy a file in your app, see the CopyAsync 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
CopyAsync(IStorageFolder)
CopyAsync(IStorageFolder, String, NameCollisionOption)
StorageFile.CopyAsync

 

 

Show:
© 2015 Microsoft