Поделиться через


StorageFile.RenameAsync Метод

Определение

Перегрузки

RenameAsync(String)

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

RenameAsync(String, NameCollisionOption)

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

RenameAsync(String)

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

public:
 virtual IAsyncAction ^ RenameAsync(Platform::String ^ desiredName) = RenameAsync;
/// [Windows.Foundation.Metadata.Overload("RenameAsyncOverloadDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction RenameAsync(winrt::hstring const& desiredName);
[Windows.Foundation.Metadata.Overload("RenameAsyncOverloadDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction RenameAsync(string desiredName);
function renameAsync(desiredName)
Public Function RenameAsync (desiredName As String) As IAsyncAction

Параметры

desiredName
String

Platform::String

winrt::hstring

Нужное новое имя текущего элемента.

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

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

Реализации

M:Windows.Storage.IStorageItem.RenameAsync(System.String) M:Windows.Storage.IStorageItem.RenameAsync(Platform::String) M:Windows.Storage.IStorageItem.RenameAsync(winrt::hstring)
Атрибуты

Комментарии

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

E_INVALIDARG
E_FAIL
ERROR_FILENAME_EXCED_RANGE
ERROR_INVALID_NAME

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

См. также раздел

Применяется к

RenameAsync(String, NameCollisionOption)

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

public:
 virtual IAsyncAction ^ RenameAsync(Platform::String ^ desiredName, NameCollisionOption option) = RenameAsync;
/// [Windows.Foundation.Metadata.Overload("RenameAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction RenameAsync(winrt::hstring const& desiredName, NameCollisionOption const& option);
[Windows.Foundation.Metadata.Overload("RenameAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction RenameAsync(string desiredName, NameCollisionOption option);
function renameAsync(desiredName, option)
Public Function RenameAsync (desiredName As String, option As NameCollisionOption) As IAsyncAction

Параметры

desiredName
String

Platform::String

winrt::hstring

Нужное новое имя текущего файла.

Если в расположении текущего файла уже есть элемент, который уже имеет указанное значение desiredName, указанное свойство NameCollisionOption определяет, как Windows реагирует на конфликт.

option
NameCollisionOption

Значение перечисления, определяющее, как Windows реагирует, если desiredName совпадает с именем существующего элемента в текущем расположении файла.

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

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

Реализации

M:Windows.Storage.IStorageItem.RenameAsync(System.String,Windows.Storage.NameCollisionOption) M:Windows.Storage.IStorageItem.RenameAsync(Platform::String,Windows.Storage.NameCollisionOption) M:Windows.Storage.IStorageItem.RenameAsync(winrt::hstring,Windows.Storage.NameCollisionOption)
Атрибуты

См. также раздел

Применяется к