StorageFile.MoveAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| 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 со следующим сообщением: Значение не попадает в ожидаемый диапазон.
Возвращаемое значение
Этот метод не возвращает объект или значение.
Реализации
- Атрибуты
См. также раздел
Применяется к
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 создает уникальное имя файла.
Возвращаемое значение
Этот метод не возвращает объект или значение.
Реализации
- Атрибуты
См. также раздел
Применяется к
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 совпадает с именем существующего файла в целевой папке.
Возвращаемое значение
Этот метод не возвращает объект или значение.
Реализации
- Атрибуты