共用方式為

StorageFile.MoveAsync 方法

  • 參考

定義

命名空間:
Windows.Storage

多載

MoveAsync(IStorageFolder)

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

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

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

MoveAsync(IStorageFolder)

編輯

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

public:
 virtual IAsyncAction ^ MoveAsync(IStorageFolder ^ destinationFolder) = MoveAsync;
/// [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

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

此目的地資料夾必須是實體位置。 否則，如果目的地資料夾只存在於記憶體中，例如檔案群組，此方法會失敗並擲回 System.Exception ，並出現下列訊息： 值不會落在預期的範圍內。

傳回

IAsyncAction

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

實作

MoveAsync(IStorageFolder)
屬性
OverloadAttribute RemoteAsyncAttribute

另請參閱

適用於

MoveAsync(IStorageFolder, String)

編輯

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

public:
 virtual IAsyncAction ^ MoveAsync(IStorageFolder ^ destinationFolder, Platform::String ^ desiredNewName) = MoveAsync;
/// [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

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

此目的地資料夾必須是實體位置。 否則，如果目的地資料夾只存在於記憶體中，例如檔案群組，此方法會失敗並擲回 System.Exception ，並出現下列訊息： 值不會落在預期的範圍內。

desiredNewName
String

Platform::String

winrt::hstring

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

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

傳回

IAsyncAction

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

實作

M:Windows.Storage.IStorageFile.MoveAsync(Windows.Storage.IStorageFolder,System.String) M:Windows.Storage.IStorageFile.MoveAsync(Windows.Storage.IStorageFolder,Platform::String) M:Windows.Storage.IStorageFile.MoveAsync(Windows.Storage.IStorageFolder,winrt::hstring)
屬性
OverloadAttribute RemoteAsyncAttribute

另請參閱

適用於

MoveAsync(IStorageFolder, String, NameCollisionOption)

編輯

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

public:
 virtual IAsyncAction ^ MoveAsync(IStorageFolder ^ destinationFolder, Platform::String ^ desiredNewName, NameCollisionOption option) = MoveAsync;
/// [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

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

此目的地資料夾必須是實體位置。 否則，如果目的地資料夾只存在於記憶體中，例如檔案群組，此方法會失敗並擲回 System.Exception ，並出現下列訊息： 值不會落在預期的範圍內。

desiredNewName
String

Platform::String

winrt::hstring

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

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

option
NameCollisionOption

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

傳回

IAsyncAction

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

實作

M:Windows.Storage.IStorageFile.MoveAsync(Windows.Storage.IStorageFolder,System.String,Windows.Storage.NameCollisionOption) M:Windows.Storage.IStorageFile.MoveAsync(Windows.Storage.IStorageFolder,Platform::String,Windows.Storage.NameCollisionOption) M:Windows.Storage.IStorageFile.MoveAsync(Windows.Storage.IStorageFolder,winrt::hstring,Windows.Storage.NameCollisionOption)
屬性
OverloadAttribute RemoteAsyncAttribute

另請參閱

適用於