Compartir a través de


StorageFolder.RenameAsync Método

Definición

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

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

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

Se aplica a

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

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

Consulte también

Se aplica a