資訊
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

StorageFile.RenameAsync(String) | renameAsync(String) Method

重新命名目前的檔案。

語法


storageFile.renameAsync(desiredName).done( /* 您的成功與錯誤處理常式 */ );

參數

desiredName

類型: String [JavaScript] | System.String [.NET] | Platform::String [C++]

目前項目所需的新名稱。

傳回值

類型: IAsyncAction

當這個方法完成時,它不會傳回任何物件或值。

備註

如果您指定的名稱無效,這個方法會擲回例外狀況。若要處理指定的名稱可能無效的所有方式,您必須將下列四個例外狀況全部攔截:

E_INVALIDARG
E_FAIL
ERROR_FILENAME_EXCED_RANGE
ERROR_INVALID_NAME

 

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

需求

最低支援的用戶端

Windows 8

最低支援的伺服器

Windows Server 2012

最低支援的電話

Windows Phone 8

命名空間

Windows.Storage
Windows::Storage [C++]

中繼資料

Windows.winmd

另請參閱

StorageFile
RenameAsync(String, NameCollisionOption)

 

 

顯示: