IStorageFile.CopyAsync 方法

定義

命名空間:

Windows.Storage

多載

CopyAsync(IStorageFolder)	在指定的資料夾中建立檔案的複本。
CopyAsync(IStorageFolder, String)	使用所需的名稱，在指定的資料夾中建立檔案的複本。
CopyAsync(IStorageFolder, String, NameCollisionOption)	使用所需的名稱，在指定的資料夾中建立檔案的複本。 如果指定資料夾中的現有檔案具有相同的名稱，這個方法也會指定該怎麼做。

CopyAsync(IStorageFolder)

在指定的資料夾中建立檔案的複本。

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)

參數

destinationFolder

IStorageFolder

建立複本的目的地資料夾。

傳回

IAsyncOperation<StorageFile>

此方法完成時，它會傳回代表複本的 StorageFile 。

屬性

OverloadAttribute RemoteAsyncAttribute

另請參閱

• CopyAsync(IStorageFolder, String)
• CopyAsync(IStorageFolder, String, NameCollisionOption)
• StorageFile.CopyAsync

CopyAsync(IStorageFolder, String)

使用所需的名稱，在指定的資料夾中建立檔案的複本。

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)

參數

destinationFolder

IStorageFolder

建立複本的目的地資料夾。

desiredNewName

String

Platform::String

winrt::hstring

複製所需的名稱。

如果目的地資料夾中已有指定的 desiredNewName的現有檔案，Windows 會產生複本的唯一名稱。

傳回

IAsyncOperation<StorageFile>

此方法完成時，它會傳回代表複本的 StorageFile 。

屬性

OverloadAttribute RemoteAsyncAttribute

另請參閱

• CopyAsync(IStorageFolder)
• CopyAsync(IStorageFolder, String, NameCollisionOption)
• StorageFile.CopyAsync

CopyAsync(IStorageFolder, String, NameCollisionOption)

使用所需的名稱，在指定的資料夾中建立檔案的複本。 如果指定資料夾中的現有檔案具有相同的名稱，這個方法也會指定該怎麼做。

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)

參數

destinationFolder

IStorageFolder

建立複本的目的地資料夾。

desiredNewName

String

Platform::String

winrt::hstring

複製所需的名稱。

如果目的地資料夾中已經有指定的 desiredNewName的現有檔案，則指定的 NameCollisionOption 會決定 Windows 如何回應衝突。

option

NameCollisionOption

列舉值，決定 Windows 是否回應 desiredNewName 與目的地資料夾中現有檔案的名稱相同。

傳回

IAsyncOperation<StorageFile>

此方法完成時，它會傳回代表複本的 StorageFile 。

屬性

OverloadAttribute RemoteAsyncAttribute

另請參閱

• CopyAsync(IStorageFolder)
• CopyAsync(IStorageFolder, String)
• StorageFile.CopyAsync