IStorageFile.MoveAsync 方法

  • 參考

定義

命名空間:
Windows.Storage

多載

MoveAsync(IStorageFolder)

將目前的檔案移至指定的資料夾。
MoveAsync(IStorageFolder, String)

將目前的檔案移至指定的資料夾，並根據所需的名稱重新命名檔案。
MoveAsync(IStorageFolder, String, NameCollisionOption)

將目前的檔案移至指定的資料夾，並根據所需的名稱重新命名檔案。 如果同名的檔案已存在於指定的資料夾中，這個方法也會指定該怎麼做。

MoveAsync(IStorageFolder)

編輯

將目前的檔案移至指定的資料夾。

public:
 IAsyncAction ^ MoveAsync(IStorageFolder ^ destinationFolder);
/// [Windows.Foundation.Metadata.Overload("MoveOverloadDefaultNameAndOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction MoveAsync(IStorageFolder const& destinationFolder);
[Windows.Foundation.Metadata.Overload("MoveOverloadDefaultNameAndOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction MoveAsync(IStorageFolder destinationFolder);
function moveAsync(destinationFolder)
Public Function MoveAsync (destinationFolder As IStorageFolder) As IAsyncAction

參數

destinationFolder
IStorageFolder

移動檔案的目的地資料夾。

此目的地資料夾必須是實體位置。 否則，如果目的地資料夾只存在於記憶體中，例如檔案群組，此方法會失敗並擲回例外狀況。

傳回

IAsyncAction

這個方法不會傳回任何物件或值。

屬性
OverloadAttribute RemoteAsyncAttribute

另請參閱

適用於

MoveAsync(IStorageFolder, String)

編輯

將目前的檔案移至指定的資料夾，並根據所需的名稱重新命名檔案。

public:
 IAsyncAction ^ MoveAsync(IStorageFolder ^ destinationFolder, Platform::String ^ desiredNewName);
/// [Windows.Foundation.Metadata.Overload("MoveOverloadDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction MoveAsync(IStorageFolder const& destinationFolder, winrt::hstring const& desiredNewName);
[Windows.Foundation.Metadata.Overload("MoveOverloadDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction MoveAsync(IStorageFolder destinationFolder, string desiredNewName);
function moveAsync(destinationFolder, desiredNewName)
Public Function MoveAsync (destinationFolder As IStorageFolder, desiredNewName As String) As IAsyncAction

參數

destinationFolder
IStorageFolder

移動檔案的目的地資料夾。

此目的地資料夾必須是實體位置。 否則，如果目的地資料夾只存在於記憶體中，例如檔案群組，此方法會失敗並擲回例外狀況。

desiredNewName
String

Platform::String

winrt::hstring

移動檔案之後所需的檔案名。

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

傳回

IAsyncAction

這個方法不會傳回任何物件或值。

屬性
OverloadAttribute RemoteAsyncAttribute

另請參閱

適用於

MoveAsync(IStorageFolder, String, NameCollisionOption)

編輯

將目前的檔案移至指定的資料夾，並根據所需的名稱重新命名檔案。 如果同名的檔案已存在於指定的資料夾中，這個方法也會指定該怎麼做。

public:
 IAsyncAction ^ MoveAsync(IStorageFolder ^ destinationFolder, Platform::String ^ desiredNewName, NameCollisionOption option);
/// [Windows.Foundation.Metadata.Overload("MoveOverload")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction MoveAsync(IStorageFolder const& destinationFolder, winrt::hstring const& desiredNewName, NameCollisionOption const& option);
[Windows.Foundation.Metadata.Overload("MoveOverload")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction MoveAsync(IStorageFolder destinationFolder, string desiredNewName, NameCollisionOption option);
function moveAsync(destinationFolder, desiredNewName, option)
Public Function MoveAsync (destinationFolder As IStorageFolder, desiredNewName As String, option As NameCollisionOption) As IAsyncAction

參數

destinationFolder
IStorageFolder

移動檔案的目的地資料夾。

此目的地資料夾必須是實體位置。 否則，如果目的地資料夾只存在於記憶體中，例如檔案群組，此方法會失敗並擲回例外狀況。

desiredNewName
String

Platform::String

winrt::hstring

移動檔案之後所需的檔案名。

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

option
NameCollisionOption

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

傳回

IAsyncAction

這個方法不會傳回任何物件或值。

屬性
OverloadAttribute RemoteAsyncAttribute

另請參閱

適用於