IStorageFile.CopyAsync Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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)
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
When this method completes, it returns a StorageFile that represents the copy.
- Attributes
See also
- CopyAsync(IStorageFolder, String)
- CopyAsync(IStorageFolder, String, NameCollisionOption)
- StorageFile.CopyAsync
Applies to
CopyAsync(IStorageFolder, String)
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
When this method completes, it returns a StorageFile that represents the copy.
- Attributes
See also
- CopyAsync(IStorageFolder)
- CopyAsync(IStorageFolder, String, NameCollisionOption)
- StorageFile.CopyAsync
Applies to
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.
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
When this method completes, it returns a StorageFile that represents the copy.
- Attributes
See also
Applies to
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for