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.
Syntax
storageFile.copyAsync(destinationFolder, desiredNewName, option).done( /* Your success and error handlers */ );
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, the specified NameCollisionOption determines how Windows responds to the conflict.
- option
-
Type: 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.
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 |
|
|
Metadata |
|
See also
Build date: 2/25/2013
