Экспорт (0) Печать
Развернуть все
Информация
Запрошенная вами тема показана ниже. Однако эта тема не включена в библиотеку.

StorageFile.RenameAsync(String) | renameAsync(String) Method

Переименовывает текущий файл.

Синтаксис


storageFile.renameAsync(desiredName).done( /* Ваши обработчики ошибок и успешных операций */ );

Параметры

desiredName

Тип: String [JavaScript] | System.String [.NET] | Platform::String [C++]

Требуемое новое имя текущего элемента.

Возвращаемое значение

Тип: IAsyncAction

При завершении этого метода никакие объекты или значения не возвращаются.

Замечания

Если указано недопустимое имя, этот метод создает исключение. Для обработки всех ситуаций, когда указанное имя может быть недействительным, необходимо перехватывать все четыре из этих исключений:

E_INVALIDARG
E_FAIL
ERROR_FILENAME_EXCED_RANGE
ERROR_INVALID_NAME

 

Если файл удаляется до завершения переименования, этот метод вызывает исключение ERROR_FILE_NOT_FOUND. При использовании этого метода необходимо также перехватывать и обрабатывать данное исключение.

Требования

Минимальная версия клиента

Windows 8

Минимальная версия сервера

Windows Server 2012

Минимальная версия телефона

Windows Phone 8

Пространство имен

Windows.Storage
Windows::Storage [C++]

Метаданные

Windows.winmd

См. также

StorageFile
RenameAsync(String, NameCollisionOption)

 

 

Показ:
© 2015 Microsoft