StorageFolder.RenameAsync Methode

Definition

Namespace:

Windows.Storage

Überlädt

RenameAsync(String)	Benennt den aktuellen Ordner um.
RenameAsync(String, NameCollisionOption)	Benennt den aktuellen Ordner um und gibt an, was zu tun ist, wenn bereits ein Ordner mit demselben Namen vorhanden ist.

RenameAsync(String)

Benennt den aktuellen Ordner um.

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

Parameter

desiredName

String

Platform::String

winrt::hstring

Der gewünschte, neue Name für den aktuellen Ordner.

Gibt zurück

IAsyncAction

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

Implementiert

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

Attribute

OverloadAttribute RemoteAsyncAttribute

Hinweise

Wenn der angegebene Name ungültig ist, löst diese Methode (und ihre Überladung) 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

• RenameAsync(String, NameCollisionOption)

RenameAsync(String, NameCollisionOption)

Benennt den aktuellen Ordner um und gibt an, was zu tun ist, wenn bereits ein Ordner mit demselben Namen vorhanden ist.

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

Parameter

desiredName

String

Platform::String

winrt::hstring

Der gewünschte, neue Name für den aktuellen Ordner.

Wenn am Speicherort des aktuellen Ordners ein Element vorhanden ist, das bereits über den angegebenen desiredName verfügt, 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 Ordners übereinstimmt.

Gibt zurück

IAsyncAction

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

Implementiert

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)

Attribute

OverloadAttribute RemoteAsyncAttribute

Weitere Informationen

• RenameAsync(String)