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)
• MoveAsync(IStorageFolder, String, NameCollisionOption)
• StorageFile.MoveAsync

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)
• MoveAsync(IStorageFolder, String, NameCollisionOption)
• StorageFile.MoveAsync

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

另请参阅

• MoveAsync(IStorageFolder)
• MoveAsync(IStorageFolder, String)
• MoveAsync