Condividi tramite


StorageFile.RenameAsync Metodo

Definizione

Overload

RenameAsync(String)

Rinomina il file corrente.

RenameAsync(String, NameCollisionOption)

Rinomina il file corrente. Questo metodo specifica anche cosa fare se un elemento esistente nel percorso del file corrente ha lo stesso nome.

RenameAsync(String)

Rinomina il file 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 dell'elemento corrente.

Restituisce

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

Commenti

Se il nome specificato non è valido, questo metodo 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

Si applica a

RenameAsync(String, NameCollisionOption)

Rinomina il file corrente. Questo metodo specifica anche cosa fare se un elemento esistente nel percorso del file corrente ha 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 del file corrente.

Se nel percorso del file corrente è presente un elemento esistente con il nome desiderato specificato, nameCollisionOption specificato determina la risposta di Windows al conflitto.

option
NameCollisionOption

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

Restituisce

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

Vedi anche

Si applica a