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

Applies to Windows and Windows Phone

Creates a copy of the file in the specified folder.

Syntax


Public Function CopyAsync(
  destinationFolder As IStorageFolder 
) As IAsyncOperation(Of StorageFile)

Parameters

destinationFolder

Type: IStorageFolder

The destination folder where the copy of the file is created.

Return value

Type: IAsyncOperation<StorageFile>

When this method completes, it returns a StorageFile that represents the copy of the file created in the destinationFolder.

Exceptions

ExceptionCondition
System.UnauthorizedAccessException

You don't have permission to copy a file into the destination folder.

Remarks

This method uses the FailIfExists value from the CreationCollisionOption enumeration by default. That is, this method raises an exception if a file with the same name already exists in the destination folder. If you want to handle a file name collision in a different way, call the CopyAsync(IStorageFolder, String, NameCollisionOption) method.

Examples

The following example copies a file to the specified folder by calling the CopyAsync() method.

No code example is currently available or this language may not be supported.

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

 

 

Show:
© 2014 Microsoft