harmony 鸿蒙@ohos.document (文件交互)

  • 2022-08-09
  • 浏览 (809)

@ohos.document (文件交互)

说明:

  • 本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
  • 本模块接口从API version 9开始废弃。不建议使用以下接口,调用以下接口将抛出异常。

导入模块

import document from '@ohos.document';

document.choose(deprecated)

choose(types?: string[]): Promise<string>

通过文件管理器选择文件,异步返回文件URI,使用promise形式返回结果。

系统能力:SystemCapability.FileManagement.UserFileService

参数:

参数名 类型 必填 说明
types string[] 限定文件选择的类型

返回值:

类型 说明
Promise<string> 异步返回文件URI(注:当前返回错误码)

示例:

  let types: Array<string> = [];
  document.choose(types);

document.choose(deprecated)

choose(callback:AsyncCallback&lt;string&gt;): void

通过文件管理器选择文件,异步返回文件URI,使用callback形式返回结果。

系统能力:SystemCapability.FileManagement.UserFileService

参数:

参数名 类型 必填 说明
callback AsyncCallback&lt;string&gt; 异步获取对应文件URI(注:当前返回错误码)

示例:

  let uri: string = "";
  document.choose((err: TypeError, uri: string) => {
    //do something with uri
  });

document.choose(deprecated)

choose(types:string[], callback:AsyncCallback&lt;string&gt;): void

通过文件管理器选择文件,异步返回文件URI,使用callback形式返回结果。

系统能力:SystemCapability.FileManagement.UserFileService

参数:

参数名 类型 必填 说明
types string[] 限定选择文件的类型
callback AsyncCallback&lt;string&gt; 异步获取对应文件URI(注:当前返回错误码)

示例:

  let types: Array<string> = [];
  let uri: string = "";
  document.choose(types, (err: TypeError, uri: string) => {
    //do something with uri
  });

document.show(deprecated)

show(uri:string, type:string):Promise&lt;void&gt;

异步打开URI对应的文件,使用promise形式返回结果。

系统能力:SystemCapability.FileManagement.UserFileService

参数:

参数名 类型 必填 说明
uri string 待打开的文件URI
type string 待打开文件的类型

返回值:

类型 说明
Promise&lt;void&gt; Promise回调返回void表示成功打开文件(注:当前返回错误码)

示例:

  let type: string = "";
  let uri: string = "";
  document.show(uri, type);

document.show(deprecated)

show(uri:string, type:string, callback:AsyncCallback&lt;void&gt;): void

异步打开URI对应的文件,使用callback形式返回结果。

系统能力:SystemCapability.FileManagement.UserFileService

参数:

参数名 类型 必填 说明
uri string 待打开的文件URI
type string 待打开文件的类型
callback AsyncCallback&lt;void&gt; 异步打开uri对应文件(注:当前返回错误码)

示例:

  let type: string = "";
  let uri: string = "";
  document.show(uri, type, (err: TypeError) => {
    //do something
  });

你可能感兴趣的鸿蒙文章

harmony 鸿蒙接口

harmony 鸿蒙系统公共事件定义(待停用)

harmony 鸿蒙系统公共事件定义

harmony 鸿蒙开发说明

harmony 鸿蒙企业设备管理概述(仅对系统应用开放)

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)

harmony 鸿蒙@ohos.distributedBundle (分布式包管理)

harmony 鸿蒙@ohos.bundle (Bundle模块)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)

0  赞