Freigeben über


IStorageItem.RenameAsync Methode

Definition

Überlädt

RenameAsync(String)

Benennt das aktuelle Element um.

RenameAsync(String, NameCollisionOption)

Benennt das aktuelle Element um. Diese Methode gibt auch an, was zu tun ist, wenn ein vorhandenes Element am Speicherort des aktuellen Elements denselben Namen hat.

RenameAsync(String)

Benennt das aktuelle Element um.

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 IAsyncAction

Parameter

desiredName
String

Platform::String

winrt::hstring

Der gewünschte, neue Name des Elements.

Gibt zurück

Bei Abschluss dieser Methode wird kein Objekt oder Wert zurückgegeben.

Attribute

Hinweise

Wenn der angegebene Name für diese Methode und ihre Überladung ungültig ist, löst diese Methode eine Ausnahme aus. Um alle Arten zu behandeln, in denen der angegebene Name ungültig sein kann, müssen Sie alle vier dieser Ausnahmen abfangen:

E_INVALIDARG
E_FAIL
ERROR_FILENAME_EXCED_RANGE
ERROR_INVALID_NAME

Wenn die Datei gelöscht wird, bevor die Umbenennung abgeschlossen ist, löst diese Methode die ERROR_FILE_NOT_FOUND Ausnahme aus. Sie müssen diese Ausnahme auch abfangen und behandeln, wenn Sie diese Methode verwenden.

Weitere Informationen

Gilt für:

RenameAsync(String, NameCollisionOption)

Benennt das aktuelle Element um. Diese Methode gibt auch an, was zu tun ist, wenn ein vorhandenes Element am Speicherort des aktuellen Elements denselben Namen hat.

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 IAsyncAction

Parameter

desiredName
String

Platform::String

winrt::hstring

Der gewünschte, neue Name des aktuellen Elements.

Wenn am Speicherort des aktuellen Elements ein Element vorhanden ist, das bereits den angegebenen desiredName aufweist, bestimmt die angegebene NameCollisionOption , wie Windows auf den Konflikt reagiert.

option
NameCollisionOption

Der Enumerationswert, der bestimmt, wie Windows reagiert, wenn desiredName mit dem Namen eines vorhandenen Elements am Speicherort des aktuellen Elements identisch ist.

Gibt zurück

Bei Abschluss dieser Methode wird kein Objekt oder Wert zurückgegeben.

Attribute

Weitere Informationen

Gilt für: