Compartir a través de


IStorageItem.RenameAsync Método

Definición

Sobrecargas

RenameAsync(String)

Cambia el nombre del elemento actual.

RenameAsync(String, NameCollisionOption)

Cambia el nombre del elemento actual. Este método también especifica qué hacer si un elemento existente en la ubicación del elemento actual tiene el mismo nombre.

RenameAsync(String)

Cambia el nombre del elemento actual.

public:
 IAsyncAction ^ RenameAsync(Platform::String ^ desiredName);
/// [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

Parámetros

desiredName
String

Platform::String

winrt::hstring

El nuevo nombre deseado del elemento.

Devoluciones

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

Atributos

Comentarios

Para este método y su sobrecarga, si el nombre especificado no es válido, este método produce una excepción. Para controlar todas las formas en que el nombre especificado podría no ser válido, debe detectar las cuatro excepciones siguientes:

E_INVALIDARG
E_FAIL
ERROR_FILENAME_EXCED_RANGE
ERROR_INVALID_NAME

Si el archivo se elimina 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 al usar este método.

Consulte también

Se aplica a

RenameAsync(String, NameCollisionOption)

Cambia el nombre del elemento actual. Este método también especifica qué hacer si un elemento existente en la ubicación del elemento actual tiene el mismo nombre.

public:
 IAsyncAction ^ RenameAsync(Platform::String ^ desiredName, NameCollisionOption option);
/// [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

Parámetros

desiredName
String

Platform::String

winrt::hstring

El nuevo nombre deseado del elemento actual.

Si hay un elemento existente en la ubicación del elemento actual que ya tiene el desiredName especificado, el NameCollisionOption especificado determina cómo Responde Windows al conflicto.

option
NameCollisionOption

Valor de enumeración que determina cómo responde Windows si desiredName es el mismo que el nombre de un elemento existente en la ubicación del elemento actual.

Devoluciones

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

Atributos

Consulte también

Se aplica a