IStorageItem.RenameAsync Método

Definición

Espacio de nombres:

Windows.Storage

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

IAsyncAction

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

Atributos

OverloadAttribute RemoteAsyncAttribute

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

• RenameAsync(String, NameCollisionOption)

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

IAsyncAction

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

Atributos

OverloadAttribute RemoteAsyncAttribute

Consulte también

• RenameAsync(String)