MSDN Library
Collapse the table of content
Expand the table of content
Información
El tema que ha solicitado se muestra abajo. Sin embargo, este tema no se encuentra en la biblioteca.

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

Cambia el nombre del archivo actual.

Sintaxis


storageFile.renameAsync(desiredName).done( /* Tus controladores de éxitos y errores */ );

Parámetros

desiredName

Tipo: String [JavaScript] | System.String [.NET] | Platform::String [C++]

El nuevo nombre deseado para el elemento actual.

Valor devuelto

Tipo: IAsyncAction

Este método no devuelve ningún objeto o valor cuando finaliza.

Observaciones

Si especifica un nombre no válido, este método inicia una excepción. Para controlar todas las formas en que el nombre especificado podría ser no válido, debe detectar estas cuatro excepciones:

E_INVALIDARG
E_FAIL
ERROR_FILENAME_EXCED_RANGE
ERROR_INVALID_NAME

 

Si se elimina el archivo antes de que finalice el cambio de nombre, este método produce la excepción ERROR_FILE_NOT_FOUND. También debe detectar y controlar esta excepción cuando utilice este método.

Requisitos

Cliente mínimo compatible

Windows 8

Servidor mínimo compatible

Windows Server 2012

Teléfono mínimo compatible

Windows Phone 8

Espacio de nombres

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

Metadatos

Windows.winmd

Consulta también

StorageFile
RenameAsync(String, NameCollisionOption)

 

 

Mostrar:
© 2016 Microsoft