StorageFolder.RenameAsync Metodo

Definizione

Spazio dei nomi:

Windows.Storage

Overload

RenameAsync(String)	Rinomina la cartella corrente.
RenameAsync(String, NameCollisionOption)	Rinomina la cartella corrente e specifica cosa fare se esiste già una cartella con lo stesso nome.

RenameAsync(String)

Rinomina la cartella corrente.

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

Parametri

desiredName

String

Platform::String

winrt::hstring

Nuovo nome desiderato per la cartella corrente.

Restituisce

IAsyncAction

Nessun oggetto o valore viene restituito da questo metodo al termine.

Implementazioni

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

Attributi

OverloadAttribute RemoteAsyncAttribute

Commenti

Se il nome specificato non è valido, questo metodo (e il relativo overload) genera un'eccezione. Per gestire tutti i modi in cui il nome specificato potrebbe non essere valido, è necessario rilevare tutte e quattro queste eccezioni:

E_INVALIDARG

E_FAIL

ERROR_FILENAME_EXCED_RANGE

ERROR_INVALID_NAME

Se il file viene eliminato prima del completamento della ridenominazione, questo metodo genera l'eccezione ERROR_FILE_NOT_FOUND. È anche necessario rilevare e gestire questa eccezione quando si usa questo metodo.

Vedi anche

• RenameAsync(String, NameCollisionOption)

RenameAsync(String, NameCollisionOption)

Rinomina la cartella corrente e specifica cosa fare se esiste già una cartella con lo stesso 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

Parametri

desiredName

String

Platform::String

winrt::hstring

Nuovo nome desiderato per la cartella corrente.

Se è presente un elemento esistente nel percorso della cartella corrente che ha già il nome desiderato specificato, nameCollisionOption specificato determina il modo in cui Windows risponde al conflitto.

option

NameCollisionOption

Valore enumerazione che determina come Windows risponde se il nome desiredName corrisponde al nome di un elemento esistente nel percorso della cartella corrente.

Restituisce

IAsyncAction

Nessun oggetto o valore viene restituito da questo metodo al termine.

Implementazioni

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)

Attributi

OverloadAttribute RemoteAsyncAttribute

Vedi anche

• RenameAsync(String)