StorageFolder.RenameAsync Método

Definição

Namespace:

Windows.Storage

Sobrecargas

RenameAsync(String)	Renomeia a pasta atual.
RenameAsync(String, NameCollisionOption)	Renomeia a pasta atual e especifica o que fazer se já existir uma pasta com o mesmo nome.

RenameAsync(String)

Renomeia a pasta atual.

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

O novo nome desejado para a pasta atual.

Retornos

IAsyncAction

Nenhum objeto ou valor é retornado por esse método quando ele é concluído.

Implementações

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

Atributos

OverloadAttribute RemoteAsyncAttribute

Comentários

Se o nome especificado for inválido, esse método (e sua sobrecarga) gerará uma exceção. Para lidar com todas as maneiras pelas quais o nome especificado pode ser inválido, você deve capturar todas essas quatro exceções:

E_INVALIDARG

E_FAIL

ERROR_FILENAME_EXCED_RANGE

ERROR_INVALID_NAME

Se o arquivo for excluído antes da renomeação ser concluída, esse método gerará a exceção ERROR_FILE_NOT_FOUND. Você também deve capturar e manipular essa exceção ao usar esse método.

Confira também

• RenameAsync(String, NameCollisionOption)

RenameAsync(String, NameCollisionOption)

Renomeia a pasta atual e especifica o que fazer se já existir uma pasta com o mesmo nome.

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

O novo nome desejado para a pasta atual.

Se houver um item existente no local da pasta atual que já tenha o desiredName especificado, o NameCollisionOption especificado determinará como o Windows responde ao conflito.

option

NameCollisionOption

O valor de enumeração que determina como o Windows responde se desiredName é o mesmo que o nome de um item existente no local da pasta atual.

Retornos

IAsyncAction

Nenhum objeto ou valor é retornado por esse método quando ele é concluído.

Implementações

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

Confira também

• RenameAsync(String)