IStorageItem.RenameAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| RenameAsync(String) |
Rinomina l'elemento corrente. |
| RenameAsync(String, NameCollisionOption) |
Rinomina l'elemento corrente. Questo metodo specifica anche cosa fare se un elemento esistente nella posizione dell'elemento corrente ha lo stesso nome. |
RenameAsync(String)
Rinomina l'elemento corrente.
public:
IAsyncAction ^ RenameAsync(Platform::String ^ desiredName);/// [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 IAsyncActionParametri
- desiredName
-
String
Platform::String
winrt::hstring
Nuovo nome dell'elemento desiderato.
Restituisce
Nessun oggetto o valore viene restituito da questo metodo al termine.
- Attributi
Commenti
Per questo metodo e il relativo overload, 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 l'elemento corrente. Questo metodo specifica anche cosa fare se un elemento esistente nella posizione dell'elemento corrente ha lo stesso nome.
public:
IAsyncAction ^ RenameAsync(Platform::String ^ desiredName, NameCollisionOption option);/// [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 IAsyncActionParametri
- desiredName
-
String
Platform::String
winrt::hstring
Nuovo nome dell'elemento corrente.
Se è presente un elemento esistente nella posizione dell'elemento 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 nella posizione dell'elemento corrente.
Restituisce
Nessun oggetto o valore viene restituito da questo metodo al termine.
- Attributi