导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

IStorageItem.RenameAsync(String, NameCollisionOption) Method

重命名当前项。如果当前项的位置中现有文件已具有相同项,则此方法还指定解决方法。

语法


IAsyncAction RenameAsync(
  string desiredName, 
  NameCollisionOption option
)

参数

desiredName

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

当前项所需的新名称。

如果在已经指定 desiredName 的当前项的位置中存在现有项,则指定的 NameCollisionOption 将确定 Windows 如何响应冲突。

option

类型: NameCollisionOption

desiredName 与当前项位置中现有项的名称相同的情况下,确定 Windows 的响应方式的枚举值。

返回值

类型: 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

另请参阅

IStorageItem
RenameAsync(String)

 

 

显示:
© 2014 Microsoft