StorageFolder.RenameAsync Método

Definición

Espacio de nombres:

Windows.Storage

Sobrecargas

RenameAsync(String)	Cambia el nombre de la carpeta actual.
RenameAsync(String, NameCollisionOption)	Cambia el nombre de la carpeta actual y especifica qué hacer si ya existe una carpeta con el mismo nombre.

RenameAsync(String)

Cambia el nombre de la carpeta actual.

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

Parámetros

desiredName

String

Platform::String

winrt::hstring

Nombre nuevo deseado para la carpeta actual.

Devoluciones

IAsyncAction

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

Implementaciones

M:Windows.Storage.IStorageItem.RenameAsync(System.String) M:Windows.Storage.IStorageItem.RenameAsync(Platform::String) M:Windows.Storage.IStorageItem.RenameAsync(winrt::hstring)

Atributos

OverloadAttribute RemoteAsyncAttribute

Comentarios

Si el nombre especificado no es válido, este método (y su sobrecarga) 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 de la carpeta actual y especifica qué hacer si ya existe una carpeta con el mismo nombre.

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

Parámetros

desiredName

String

Platform::String

winrt::hstring

Nombre nuevo deseado para la carpeta actual.

Si hay un elemento existente en la ubicación de la carpeta actual que ya tiene el desiredName especificado, 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 de la carpeta actual.

Devoluciones

IAsyncAction

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

Implementaciones

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)

Atributos

OverloadAttribute RemoteAsyncAttribute

Consulte también

• RenameAsync(String)