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

重命名当前文件夹。

语法


storageFolder.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

另请参阅

StorageFolder
RenameAsync(String, NameCollisionOption)

 

 

显示:
© 2014 Microsoft