Share via

IStorageFile.CopyAsync Method

  • Reference

Definition

Namespace:
Windows.Storage

Overloads

CopyAsync(IStorageFolder)

Creates a copy of the file in the specified folder.
CopyAsync(IStorageFolder, String)

Creates a copy of the file in the specified folder, using the desired name.
CopyAsync(IStorageFolder, String, NameCollisionOption)

Creates a copy of the file in the specified folder, using the desired name. This method also specifies what to do if an existing file in the specified folder has the same name.

CopyAsync(IStorageFolder)

Edit

Creates a copy of the file in the specified folder.

public:
 IAsyncOperation<StorageFile ^> ^ CopyAsync(IStorageFolder ^ destinationFolder);
/// [Windows.Foundation.Metadata.Overload("CopyOverloadDefaultNameAndOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageFile> CopyAsync(IStorageFolder const& destinationFolder);
[Windows.Foundation.Metadata.Overload("CopyOverloadDefaultNameAndOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageFile> CopyAsync(IStorageFolder destinationFolder);
function copyAsync(destinationFolder)
Public Function CopyAsync (destinationFolder As IStorageFolder) As IAsyncOperation(Of StorageFile)

Parameters

destinationFolder
IStorageFolder

The destination folder where the copy is created.

Returns

IAsyncOperation<StorageFile>

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

Attributes
OverloadAttribute RemoteAsyncAttribute

See also

Applies to

CopyAsync(IStorageFolder, String)

Edit

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

public:
 IAsyncOperation<StorageFile ^> ^ CopyAsync(IStorageFolder ^ destinationFolder, Platform::String ^ desiredNewName);
/// [Windows.Foundation.Metadata.Overload("CopyOverloadDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageFile> CopyAsync(IStorageFolder const& destinationFolder, winrt::hstring const& desiredNewName);
[Windows.Foundation.Metadata.Overload("CopyOverloadDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageFile> CopyAsync(IStorageFolder destinationFolder, string desiredNewName);
function copyAsync(destinationFolder, desiredNewName)
Public Function CopyAsync (destinationFolder As IStorageFolder, desiredNewName As String) As IAsyncOperation(Of StorageFile)

Parameters

destinationFolder
IStorageFolder

The destination folder where the copy is created.

desiredNewName
String

Platform::String

winrt::hstring

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.

Returns

IAsyncOperation<StorageFile>

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

Attributes
OverloadAttribute RemoteAsyncAttribute

See also

Applies to

CopyAsync(IStorageFolder, String, NameCollisionOption)

Edit

Creates a copy of the file in the specified folder, using the desired name. This method also specifies what to do if an existing file in the specified folder has the same name.

public:
 IAsyncOperation<StorageFile ^> ^ CopyAsync(IStorageFolder ^ destinationFolder, Platform::String ^ desiredNewName, NameCollisionOption option);
/// [Windows.Foundation.Metadata.Overload("CopyOverload")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageFile> CopyAsync(IStorageFolder const& destinationFolder, winrt::hstring const& desiredNewName, NameCollisionOption const& option);
[Windows.Foundation.Metadata.Overload("CopyOverload")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageFile> CopyAsync(IStorageFolder destinationFolder, string desiredNewName, NameCollisionOption option);
function copyAsync(destinationFolder, desiredNewName, option)
Public Function CopyAsync (destinationFolder As IStorageFolder, desiredNewName As String, option As NameCollisionOption) As IAsyncOperation(Of StorageFile)

Parameters

destinationFolder
IStorageFolder

The destination folder where the copy is created.

desiredNewName
String

Platform::String

winrt::hstring

The desired name of the copy.

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

Returns

IAsyncOperation<StorageFile>

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

Attributes
OverloadAttribute RemoteAsyncAttribute

See also

Applies to