共用方式為


IStorageItem.RenameAsync 方法

定義

多載

RenameAsync(String)

重新命名目前的專案。

RenameAsync(String, NameCollisionOption)

重新命名目前的專案。 如果目前專案位置中的現有專案具有相同的名稱,這個方法也會指定該怎麼做。

RenameAsync(String)

重新命名目前的專案。

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

參數

desiredName
String

Platform::String

winrt::hstring

所需的專案新名稱。

傳回

此方法在完成時不會傳回任何物件或值。

屬性

備註

針對這個方法及其多載,如果您指定的名稱無效,這個方法會擲回例外狀況。 若要處理指定名稱可能不正確所有方式,您必須攔截這四個例外狀況:

E_INVALIDARG
E_FAIL
ERROR_FILENAME_EXCED_RANGE
ERROR_INVALID_NAME

如果在重新命名完成之前刪除檔案,這個方法會擲回ERROR_FILE_NOT_FOUND例外狀況。 當您使用此方法時,也必須攔截並處理這個例外狀況。

另請參閱

適用於

RenameAsync(String, NameCollisionOption)

重新命名目前的專案。 如果目前專案位置中的現有專案具有相同的名稱,這個方法也會指定該怎麼做。

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

參數

desiredName
String

Platform::String

winrt::hstring

目前專案所需的新名稱。

如果目前專案的位置中有已具有指定 desiredName的現有專案,則指定的 NameCollisionOption 會決定 Windows 如何回應衝突。

option
NameCollisionOption

列舉值,決定 Windows 回應方式,如果 desiredName 與目前專案位置中現有專案的名稱相同。

傳回

此方法在完成時不會傳回任何物件或值。

屬性

另請參閱

適用於