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

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

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

一个枚举值，确定如果 desiredNewName 与目标文件夹中现有文件的名称相同，则 Windows 的响应方式。

返回

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

另请参阅

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